Sign in
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

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.

Changes