v51

OpenAPI 3.0.0GPL-3.0raw.githubusercontent.com2026-08-01199241439.9 KB
dag-runs

List all DAG-runs

Retrieves a list of all DAG-runs with optional filtering by name and status

get/dag-runs

Query parameters

statusStatus[]

status of the DAG-run. Repeat the parameter to match multiple statuses.

fromDateinteger

Unix timestamp in seconds

Example:1672531199

start datetime for filtering DAG-runs in ISO 8601 format with timezone

toDateinteger

Unix timestamp in seconds

Example:1672531199

end datetime for filtering DAG-runs in ISO 8601 format with timezone

dagRunIdstring

Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.

Example:latest

ID of the DAG-run or 'latest' to get the most recent DAG-run

limitinteger

Maximum number of DAG-runs to return (default 100)

cursorstring

Opaque cursor for loading the next page of older DAG-runs

remoteNodestring

name of the remote node

workspacestring

Workspace selector. For list and search APIs, use all, default, or a workspace name. Omitted means all.

namestring

Filter DAG-runs by name

labelsstring

Filter DAG-runs by DAG labels (comma-separated). Returns runs from DAGs that have ALL specified labels. Mutually exclusive with tags; the server returns HTTP 400 if both are set.

tagsstring

Deprecated alias for labels; mutually exclusive with labels. Filter DAG-runs by DAG labels (comma-separated).

Response

A successful response

nextCursorstring

Opaque cursor for loading the next page of older DAG-runs

Example response

{
  "dagRuns": [
    {
      "dagRunId": "latest"
    }
  ]
}