Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-205391153.1 KB

4a74befa0bde

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_filter, trigger_filter. Order with order_by ('<field> <asc|desc>'), field one of status, started_at, completed_at, created_at.

get/runs

Query parameters

workflow_idstring uuid

Filter results to a single workflow.

Filter results to a single workflow.

limitinteger

Maximum number of runs to return per page (1-500).

Maximum number of runs to return per page (1-500).

offsetinteger

Pagination offset.

Pagination offset.

searchstring

Filter by run id substring.

Filter by run id substring.

status_filterstring[] nullable

Restrict results to the given run statuses.

Restrict results to the given run statuses.

trigger_filterstring[] nullable

Restrict results to the given triggers.

Restrict results to the given triggers.

order_bystring

Sort expression '<field> <asc|desc>'; field is one of status, started_at, completed_at, created_at. Defaults to created_at desc.

Sort expression '<field> <asc|desc>'; field is one of status, started_at, completed_at, created_at. Defaults to created_at desc.

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"
    }
  ]
}