Task Runs

List task runs

Returns a paginated list of task runs. Supports filtering by agent, credential, source, task, workflow, status, result, and date range.

get/task-runs

Query parameters

integer

string int32

Maximum number of items to return (1-100, default 20)

cursorstring

Cursor from a previous response for pagination.

statusstring[]

Filter by status: queued, running, canceling, interaction_required, review_required, completed, canceled, failed

source_idstring[]

Filter by source ID

outcomestring[]

Filter by run result: success, failure, unknown. Maps to the result field on the task run object.

agent_idstring

Unique identifier for the agent (prefixed with agt_).

credential_idstring

Unique identifier for the credential (prefixed with cred_).

task_idstring

Unique identifier for the task (prefixed with task_).

workflow_idstring

Filter by workflow ID.

trigger_idstring

Filter to runs created by this trigger. Prefixed with trg_.

created_afterstring date-time

Return runs created after this timestamp (ISO 8601).

created_beforestring date-time

Return runs created before this timestamp (ISO 8601).

searchstring

Free-text search matching task name, task ID, or task run ID.

has_moreboolean

true if there are more results beyond this page.

next_cursorstring nullable

Opaque cursor string to pass as the cursor query parameter on the next request. null when there are no more pages.

request_idstring nullable

Unique identifier for the API request.