Skip to main content
GET
List task runs

Authorizations

Authorization
string
header
required

Secret key (sk_live_...)

Query Parameters

limit
default:20

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

Required range: 1 <= x <= 100
Example:

20

cursor
string

Cursor from a previous response for pagination.

status
string[]

Filter by status: queued, running, canceling, interaction_required, review_required, completed, canceled, failed. Pass multiple values comma-separated (e.g. ?status=a,b); repeated keys are also accepted.

source_id
string[]

Filter by source ID. Pass multiple values comma-separated (e.g. ?source_id=a,b); repeated keys are also accepted.

outcome
string[]

Filter by run result: success, failure, unknown. Maps to the result field on the task run object. Pass multiple values comma-separated (e.g. ?outcome=a,b); repeated keys are also accepted.

agent_id
string

Unique identifier for the agent (prefixed with agt_).

Pattern: ^agt_
Example:

"agt_AbC123xYz456"

credential_id
string

Unique identifier for the credential (prefixed with cred_).

Pattern: ^cred_
Example:

"cred_AbC123xYz456"

task_id
string

Unique identifier for the task (prefixed with task_).

Pattern: ^task_
Example:

"task_AbC123xYz456"

workflow_id
string

Filter by workflow ID. Workflow management endpoints are not yet publicly available; workflow IDs appear on runs created by workflows.

trigger_id
string

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

created_after
string<date-time>

Return runs created after this timestamp (ISO 8601).

Example:

"2026-08-24T12:00:00Z"

created_before
string<date-time>

Return runs created before this timestamp (ISO 8601).

Example:

"2026-08-24T12:00:00Z"

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

Response

OK

data
object[]
required

Array of resource objects for the current page.

has_more
boolean
required

true if there are more results beyond this page.

next_cursor
null | string

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

request_id
null | string

Unique identifier for the API request.