Sign in

v12

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

List run history

Returns paginated historic runs for the caller's user. Use POST /runs for recent (non-archived) runs.

post/runs/history

Request body

$schemastring uri

A URL to the JSON Schema for this object.

end_datestring date-time required

End of the query time window.

limitinteger required

Maximum number of runs to return.

offsetinteger required

Pagination offset.

searchstring

Filters by run ID or workflow ID substring.

start_datestring date-time required

Beginning of the query time window.

status_filterstring[] nullable

Restricts results to runs in the given statuses (case-insensitive).

workflow_idstring

Filters results to a single workflow.

Example request

{
  "$schema": "/api/v1/RunHistoryRequest.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/RunHistoryResponse.json"
}