Skip to main content
GET
List Tasks

Query Parameters

agent_id
string | null
agent_name
string | null
status
enum<string> | null

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

Available options:
CANCELED,
COMPLETED,
FAILED,
RUNNING,
TERMINATED,
TIMED_OUT,
DELETED
task_metadata
string | null

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

limit
integer
default:50
page_number
integer
default:1
order_by
string | null
order_direction
string
default:desc
relationships
enum<string>[]

Task relationships that can be loaded

Available options:
agents

Response

Successful Response

id
string
required
name
string | null
status
enum<string> | null
Available options:
CANCELED,
COMPLETED,
FAILED,
RUNNING,
TERMINATED,
TIMED_OUT,
DELETED
status_reason
string | null
created_at
string<date-time> | null
updated_at
string<date-time> | null
cleaned_at
string<date-time> | null
params
Task parameters · object | null
task_metadata
Task metadata · object | null
agents
Agent · object[] | null