Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.

Path Parameters

org_id
string
required
project_id
string
required

Query Parameters

user_id
string | null

Filter runs by user ID

status
string | null

Filter runs by status

sentiment
string | null

Filter runs by sentiment

group_id
string | null

Filter runs by group ID

workforce_id
string | null

Filter runs by workforce ID

rev
string | null

Filter runs by the git branch they were executed against (e.g. main). Runs without a recorded branch are always included for backwards compatibility with rows created before this field was tracked.

from
integer<int64> | null

Filter runs by start time (epoch timestamp in milliseconds)

to
integer<int64> | null

Filter runs by end time (epoch timestamp in milliseconds)

metadata
string | null

Filter runs by metadata

roots
boolean

When true, return only thread roots (runs that start a conversation, i.e. have no parent). For a root run, group_id equals its own id.

sort_by
null | any

Sort field (id, created_at, duration_ms, cost_usd, cost_credits)

sort_order
null | any

Sort direction (asc or desc; default desc)

page_token
string | null

Page token

Response

Runs listed successfully

runs
object[]
required

List of runs

next_page_token
string | null

Cursor for the next page