Skip to main content
GET
List task runs

Authorizations

Authorization
string
header
required

Secret key (sk_live_...)

Query Parameters

limit

Maximum number of items to return (1-100, default 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

source_id
string[]

Filter by source ID

outcome
string[]

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

agent_id
string

Unique identifier for the agent (prefixed with agt_).

credential_id
string

Unique identifier for the credential (prefixed with cred_).

task_id
string

Unique identifier for the task (prefixed with task_).

workflow_id
string

Filter by workflow ID.

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).

created_before
string<date-time>

Return runs created before this timestamp (ISO 8601).

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

Response

OK

data
object[]

Array of resource objects for the current page.

has_more
boolean

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.