airflow_list_dag_runs
Retrieve and filter DAG runs from Apache Airflow with pagination, sorting, and direct UI links for monitoring workflow executions.
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", or"execution_date"(omit to useexecution_date)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 |
|---|---|---|---|
| instance | No | ||
| ui_url | No | ||
| dag_id | No | ||
| limit | No | ||
| offset | No | ||
| state | No | ||
| order_by | No | ||
| descending | No |