list_dag_runs
List recent DAG runs by dag_id to monitor status and diagnose failures, with optional state filters and pagination, even without a run_id.
Instructions
List recent runs of a DAG — useful when you don't already hold a run_id.
Args: dag_id: DAG identifier. Pass "~" to list runs across all DAGs. limit: Max runs to return (default 25). offset: Pagination offset. state: Optional filter, e.g. ["running"], ["failed"], ["success", "queued"].
Returns:
DagRunList with dag_runs (each a DagRunSummary) and total_entries.
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 |
|---|---|---|---|
| limit | No | ||
| state | No | ||
| dag_id | Yes | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dag_runs | Yes | ||
| total_entries | No |