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

4a74befa0bde

runs

List run history

Returns paginated historic runs for the caller's user over a required time window (start_date/end_date). Use GET /runs for recent (non-archived) runs.

get/runs/history

Query parameters

start_datestring date-time required

Beginning of the query time window (RFC 3339).

Beginning of the query time window (RFC 3339).

end_datestring date-time required

End of the query time window (RFC 3339).

End of the query time window (RFC 3339).

workflow_idstring

Filter results to a single workflow.

Filter results to a single workflow.

limitinteger

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

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

offsetinteger

Pagination offset.

Pagination offset.

status_filterstring[] nullable

Restrict results to the given run statuses (case-insensitive).

Restrict results to the given run statuses (case-insensitive).

searchstring

Filter by run id or workflow id substring.

Filter by run id or workflow id substring.

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/RunHistoryResponse.json"
}