Skip to main content
GET
List all runs
Returns a paginated list of task runs across your entire organization, ordered from newest to oldest. Use this for cross-task dashboards, monitoring, and audit trails. To list runs for a specific task, you can either use this endpoint with the taskId filter or use the task-scoped List Task Runs endpoint.

Request

Query parameters

  • limit (integer, optional) — Number of runs to return per page. Min 1, max 100, default 20.
  • offset (integer, optional) — Number of runs to skip for pagination. Default 0.
  • status (string, optional) — Filter by run status: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED.
  • taskId (UUID, optional) — Filter runs to a specific task.
  • since (string, optional) — ISO 8601 timestamp. Only return runs created after this time. Defaults to 7 days ago.
  • until (string, optional) — ISO 8601 timestamp. Only return runs created before this time.

Example

Responses

  • 200 OK — Returns { "runs": Run[], "total": int, "limit": int, "offset": int }.
  • 400 Bad Request — Invalid task ID or status filter.
  • 401 Unauthorized — Missing or malformed API key.
Each run object matches the schema described in the introduction.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:20

Number of runs per page (1-100, default 20).

Required range: 1 <= x <= 100
offset
integer
default:0

Number of runs to skip.

Required range: x >= 0
status
enum<string>

Filter by run status.

Available options:
PENDING,
RUNNING,
COMPLETED,
FAILED,
CANCELLED
taskId
string<uuid>

Filter runs to a specific task.

since
string<date-time>

ISO 8601 timestamp. Only return runs created after this time. Defaults to 7 days ago.

until
string<date-time>

ISO 8601 timestamp. Only return runs created before this time.

Response

Runs returned successfully.

runs
object[]
required
total
integer
required
limit
integer
required
offset
integer
required