airflow_list_dag_runs
List DAG runs from Apache Airflow with filtering by state and sorting by date, including pagination and direct UI links to each run.
Instructions
List DAG runs (defaults to execution_date DESC) with per-run UI URLs.
Parameters
instance: Instance key (optional)
ui_url: Airflow UI URL to resolve instance/dag_id (optional)
dag_id: DAG identifier (required if ui_url not provided)
limit: Max results (default 100; accepts int/float/str, coerced to non-negative int, fractional values truncated)
offset: Offset for pagination (default 0; accepts int/float/str, coerced to non-negative int, fractional values truncated)
state: List of states to filter by (optional)
order_by: Optional
"start_date","end_date","execution_date", or"logical_date"(omit to useexecution_date; execution_date and logical_date are mapped to whichever name the target Airflow version uses)descending: Sort direction (default True). Ignored when order_by is omitted; defaults always use execution_date descending
Returns
Response dict: { "dag_runs": [{ "dag_run_id", "state", "start_date", "end_date", "ui_url" }], "count": int, "request_id": str }
Raises: ToolError with compact JSON payload (
code,message,request_id, optionalcontext)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| state | No | ||
| dag_id | No | ||
| offset | No | ||
| ui_url | No | ||
| instance | No | ||
| order_by | No | ||
| descending | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||