Skip to main content
GET
Typescript (SDK)

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Query Parameters

status
string

Filter by run status: one of pending, running, completed, failed, needs_input, timed_out, unknown, skipped, or a comma-separated list of them (e.g. failed,timed_out)

trigger_source
string

Filter by what started the run: scheduled, event or manual, or a comma-separated list. event lists the events a task received; each run carries its trigger_event.

created_after
string<date-time>

Only runs created at or after this ISO 8601 timestamp

task_id
string

Filter by the parent task's prefixed ID

chat_id
string

Only the runs of this chat (aichat_...): the run that started it and every follow-up message after it. A run id resolves to its chat.

starting_after
string

Cursor for pagination — the ID of the last item in the previous page

limit
integer
default:20

Items per page

Required range: 1 <= x <= 100

Response

List of task runs

object
enum<string>
required
Available options:
list
data
object[]
required
has_more
boolean
required
url
string
required