Sign in
Runs

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. Uppercase enum value only (e.g. COMPLETED, never completed).

Filter runs by lifecycle status. Uppercase enum value only (e.g. COMPLETED, never completed).

Response

Runs page

cursorstring

Opaque cursor for the next page. Absent on the last page.

Example response

{
  "items": [
    {
      "runId": "01JGXYZABCDEFGHJKMNPQRSTVW",
      "caller": "API_KEY#a1b2c3d4",
      "owner": "user_2abc",
      "providerResponse": {
        "httpStatus": 200
      }
    }
  ]
}

Changes