Sign in
Tasks v1

Retrieve Task Run

Retrieves run status by run_id.

The run result is available from the /result endpoint.

get/v1/tasks/runs/{run_id}

Path parameters

run_idstring required

Response

Successful Response

created_atstring nullable required

Timestamp of the creation of the task, as an RFC 3339 string.

is_activeboolean required

Whether the run is currently active, i.e. status is one of {'cancelling', 'queued', 'running'}.

metadataobject nullable

User-provided metadata stored with the run.

modified_atstring nullable required

Timestamp of the last modification to the task, as an RFC 3339 string.

processorstring required

Processor used for the run.

run_idstring required

ID of the task run.

status'queued' | 'action_required' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled' required

Status of the run.

taskgroup_idstring nullable

ID of the taskgroup to which the run belongs.

Example response

{
  "created_at": "2025-04-24T18:56:22.513132Z",
  "metadata": {},
  "modified_at": "2025-04-24T18:56:22.513132Z",
  "processor": "base",
  "run_id": "trun_e0083b6aac0544eb8686e8d2a76533d2",
  "status": "queued",
  "warnings": []
}

Changes