v1

latestOpenAPI 3.1.02026-07-263992128.7 KB

Task Runs

List task runs

Retrieve a paginated list of task 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, integrations, pipeline IDs, or task run IDs using comma-separated values. For example, status=SUCCEEDED,FAILED&integration=HTTP,SNOWFLAKE returns task runs matching either status and either integration.

get/task_runs

Query parameters

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.

statusstring

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

integrationstring

Integration identifier.

task_run_idsstring

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

Response

Successful response.

pageinteger required

pageSizeinteger required

totalinteger required