Sign in

v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB
runs

List runs

Returns paginated recent (non-archived) runs the caller started - scoped to their own user within the org, not every member's runs. Filters: workflow_id, search (run ID substring), status, trigger. Sortable fields: status, started_at, completed_at, created_at, workflow_id.

post/runs

Request body

$schemastring uri

A URL to the JSON Schema for this object.

limitinteger

Maximum number of runs to return per page.

offsetinteger

Pagination offset.

searchstring

Filters by run ID substring.

status_filterstring[] nullable

StatusFilter restricts results to runs in the given statuses.

trigger_filterstring[] nullable

TriggerFilter restricts results to runs with the given triggers.

workflow_idstring

Filters results to a single workflow.

Example request

{
  "$schema": "/api/v1/RunListRequest.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

limitinteger required

Page size used for this response.

offsetinteger required

Pagination offset used for this response.

totalinteger required

Total number of runs matching the query.

Example response

{
  "$schema": "/api/v1/RunListResponse.json",
  "runs": [
    {
      "$schema": "/api/v1/RunResponse.json"
    }
  ]
}