Answer a run that is paused on a human-input request (from list_pending_inputs). For an approval, set approved=true/false. For an input request, set value to the requested text.

Get or create an agent by name: a cloud computer running plori's agent, with its own disk, tools, and memory. If the account already has an agent with this name, that agent is returned (marked "existing": true) instead of a duplicate — safe to call repeatedly, and the right way to reconnect to an agent you used before. Creation is subject to the account's plan limits (agent count, model tier); model is ignored when an existing agent is returned (use set_agent_model to change it).

Create an empty workflow (its steps are built separately by an agent). Returns the new workflow, including its id and — for a webhook trigger — its hook URL. trigger_kind defaults to "manual" (run it on demand with run_workflow); "cron" needs a cron_expr; "webhook" mints a public hook URL.

Permanently delete an agent and revoke its disk. This cannot be undone.

Get one agent's details (name, type, model, status) by its id.

Get the authenticated account's credit balance and plan. Running agents spends credits, so check this before invoking.

Get the authenticated account's disk state (included, purchased, used bytes, and monthly cost).

Get a run's status and, if it has completed, the assistant's reply, plus a "url" that opens the run's session in the web app. Use to poll a run started with invoke_agent wait=false.

Get the authenticated account's usage rollup (spend by meter and by agent, recent runs).

Get one workflow execution's status, timing, credits, and per-step outcome. Use to poll a run started with run_workflow.

Send a message to an agent. By default waits up to ~25s for the turn to finish and returns the assistant's reply; if it is still running by then it returns a run_id with status "running" to poll via get_run_result. Agent turns can take minutes (research, multi-step or tool-heavy work). This call blocks your own turn while it waits, and no MCP client backgrounds it — so if the user is not waiting on this reply, or you expect a long turn, pass wait=false to get a run_id back immediately and poll get_run_result on your own cadence instead of holding the call open. Running an agent spends credits. If the run pauses on a human-input request it returns status "awaiting_input" (use list_pending_inputs + answer_pending_input). Every result also carries a "url" that opens this run's exact session in the web app, so a human can go read it.

List the agents owned by the authenticated account, with their model and live session status.

List the agent type plori provides. create_agent always provisions it, so this is informational and optional.

List the agent's runs that are paused awaiting a human approval or input (the HITL queue).

List an agent's run history (most recent first), with each run's status.

List the workflows owned by the authenticated account, with each one's status, trigger, and current version.

Run a workflow now — a real execution with real side effects, billed like any run (1 credit + model usage). Waits briefly and returns the execution: terminal if it finished, else status "running" to poll with get_workflow_execution. The workflow must have steps built already.

Schedule a deferred run of an agent: it will be invoked later with the given prompt. Provide either delay_seconds (relative) or fire_at (an RFC3339 timestamp).

Change an agent's model. Takes effect on the agent's next turn. Frontier models require a paid plan.