Get one run's status

get/v1/agents/{agentID}/runs/{runID}

Request

  • Base URL: https://api.plori.ai
  • URL: https://api.plori.ai/v1/agents/{agentID}/runs/{runID}
  • Auth: HTTP bearer

Path parameters

agentIDstring uuid required
runIDstring required

Response

The run.

idstring
agent_idstring uuid
workspace_idstring uuid

The Workspace the run belongs to; omitted for runs outside a Workspace.

thread_idstring uuid
statusstring
origin'user' | 'schedule' | 'background' | 'agent' | 'agent_result'
parent_run_idstring
started_atstring date-time
ended_atstring date-time
last_heartbeat_atstring date-time
cause'user_stop' | 'workspace_stop' | 'input_expired' | 'run_superseded' | 'credits_exhausted' | 'task_budget_exhausted' | 'workspace_save_refused' | 'interrupted' | 'stalled' | 'time_limit' | 'vm_capacity_unavailable' | 'backend_error' | 'spawn_failed' | 'workspace_copy_held' | 'account_disk_full' | 'agent_deleted'

Machine-readable terminal cause. After time_limit or stalled the saved work continues with a new message; vm_capacity_unavailable means no VM slot became free before the placement wait ended, and the same message can be sent again. task_budget_exhausted appears only on runs that ended before task group token figures stopped limiting model calls.

retryableboolean
creditsinteger nullable

Amount charged for the run, in micro-USD (µ$), where 1,000,000 µ$ = $1.

tokensinteger nullable
stop_reasonstring

Changes

No recorded changes to this operation across all 1 revision of this API.