v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0189112274.5 KB
Tasks

List Tasks

List tasks. Returns a lean summary per task and omits params; fetch GET /tasks/{task_id} for the full record including params.

get/tasks

Query parameters

agent_idstring nullable
agent_namestring nullable
status'CANCELED' | 'COMPLETED' | 'FAILED' | 'RUNNING' | 'INTERRUPTED' | 'TERMINATED' | 'TIMED_OUT' | 'DELETED'

Filter tasks by status (e.g. RUNNING, COMPLETED).

task_metadatastring nullable

JSON-encoded object used to filter tasks via JSONB containment. Example: {"created_by_user_id": "abc-123"}.

JSON-encoded object used to filter tasks via JSONB containment. Example: {"created_by_user_id": "abc-123"}.

limitinteger
page_numberinteger
order_bystring nullable
order_directionstring
relationshipsTaskRelationships[]

Response

Successful Response

idstring required
namestring nullable
status'CANCELED' | 'COMPLETED' | 'FAILED' | 'RUNNING' | 'INTERRUPTED' | 'TERMINATED' | 'TIMED_OUT' | 'DELETED'
status_reasonstring nullable
created_atstring date-time nullable
updated_atstring date-time nullable
cleaned_atstring date-time nullable
task_metadataobject nullable