list_dag_runs
Retrieve a list of DAG runs, sorted by execution date with the most recent first. Filter by state and control pagination with limit and offset.
Instructions
List runs of a DAG, most recent first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dag_id": "<dag_id>"
},
"name": "list_dag_runs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dag_id | Yes | The DAG to list runs for. | |
| limit | No | Max runs to return (Airflow caps this at 100). | |
| offset | No | Runs to skip. | |
| state | No | Filter by run state, e.g. ["failed", "running"]. | |
| order_by | No | Sort field; defaults to newest first. | -execution_date |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dag_runs | No | ||
| total_entries | No |