v1

latestOpenAPI 3.1.02026-07-263992128.7 KB

Pipeline Runs

List pipeline runs

Retrieve a paginated list of pipeline runs for the workspace linked to the API key.

<Note> `time_from` and `time_to` are optional. If neither is provided, the API returns the last 7 days of data. If both are provided, the maximum time range per request is 7 days. `time_from` cannot be earlier than 2023-01-01. </Note>

Filter by multiple statuses, pipeline IDs, or pipeline run IDs using comma-separated values. For example, status=SUCCEEDED,FAILED returns all pipeline runs with either status.

get/pipeline_runs

Query parameters

statusstring

Filter by status. Comma-separated values are supported where the parameter accepts multiple values.

pageinteger

Page number. Must be greater than or equal to 1.

page_sizeinteger

Number of items per page. Defaults to 50; maximum 100.

time_fromstring date-time nullable

Start of the time window as an ISO 8601 datetime.

time_tostring date-time nullable

End of the time window as an ISO 8601 datetime.

pipeline_idsstring

Filter by pipeline IDs. Provide comma-separated UUIDs for multiple values.

pipeline_run_idsstring

Filter by pipeline run IDs. Provide comma-separated UUIDs for multiple values.

environmentsstring

Filter by environment IDs. Provide comma-separated UUIDs for multiple values.

Response

Successful response.

pageinteger required

pageSizeinteger required

totalinteger required