List Runs
List runs for a project.
Authorizations
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Query Parameters
Filter runs by user ID
Filter runs by status
Filter runs by sentiment
Filter runs by group ID
Filter runs by workforce ID
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.
Filter runs by start time (epoch timestamp in milliseconds)
Filter runs by end time (epoch timestamp in milliseconds)
Filter runs by metadata
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 field (id, created_at, duration_ms, cost_usd, cost_credits)
Sort direction (asc or desc; default desc)
Page token