v1
latestOpenAPI 3.1.02026-08-044257268.7 KBRuns
List runs
Cursor-paginated list of the workspace's runs, newest first. Optional status filter.
get/v1/runs
Query parameters
limitinteger
Max items per page (server-side cap applies).
Example:20
Max items per page (server-side cap applies).
cursorstring
Cursor returned by the previous page.
Cursor returned by the previous page.
status'READY' | 'RUNNING' | 'STOPPING' | 'COMPLETED' | 'FAILED' | 'BLOCKED' | 'STOPPED' | 'TIMED_OUT'
Filter runs by lifecycle status.
Filter runs by lifecycle status.
Response
Runs page
Example response
{
"items": [
{
"runId": "01JGXYZABCDEFGHJKMNPQRSTVW",
"providerResponse": {
"httpStatus": 200
}
}
]
}