list_task_instances
List task instances for a DAG run using state, date, duration, and other Airflow filters, with cursor or offset pagination to inspect task executions.
Instructions
List task executions with all Airflow 3.3.1 API query filters.
Use '~' for all DAGs or runs. Date filters are timezone-aware ISO 8601 strings. Lists use repeated query parameters; order_by accepts '-' for descending order. cursor='' starts cursor pagination; pass returned next_cursor for the next page. When cursor is supplied, Airflow ignores offset. Patterns match substrings; prefix patterns are case-sensitive. No rendered fields or XCom values are returned. ID regexes use Python search with inline flags and combine with native filters using AND. Regex scans at most 1000 candidates before offset/limit pagination, forbids cursor, and returns a filtered total. With regex, limit=0 returns all matches.
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>",
"dag_run_id": "<dag_run_id>"
},
"name": "list_task_instances"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pool | No | ||
| limit | No | ||
| queue | No | ||
| state | No | ||
| cursor | No | ||
| dag_id | Yes | ||
| offset | No | ||
| task_id | No | ||
| executor | No | ||
| operator | No | ||
| order_by | No | ||
| map_index | No | ||
| dag_run_id | Yes | ||
| try_number | No | ||
| duration_gt | No | ||
| duration_lt | No | ||
| end_date_gt | No | ||
| end_date_lt | No | ||
| dag_id_regex | No | ||
| duration_gte | No | ||
| duration_lte | No | ||
| end_date_gte | No | ||
| end_date_lte | No | ||
| run_after_gt | No | ||
| run_after_lt | No | ||
| run_after_gte | No | ||
| run_after_lte | No | ||
| start_date_gt | No | ||
| start_date_lt | No | ||
| task_group_id | No | ||
| task_id_regex | No | ||
| updated_at_gt | No | ||
| updated_at_lt | No | ||
| dag_id_pattern | No | ||
| run_id_pattern | No | ||
| start_date_gte | No | ||
| start_date_lte | No | ||
| updated_at_gte | No | ||
| updated_at_lte | No | ||
| version_number | No | ||
| logical_date_gt | No | ||
| logical_date_lt | No | ||
| logical_date_gte | No | ||
| logical_date_lte | No | ||
| pool_name_pattern | No | ||
| queue_name_pattern | No | ||
| dag_id_prefix_pattern | No | ||
| operator_name_pattern | No | ||
| run_id_prefix_pattern | No | ||
| pool_name_prefix_pattern | No | ||
| queue_name_prefix_pattern | No | ||
| task_display_name_pattern | No | ||
| rendered_map_index_pattern | No | ||
| operator_name_prefix_pattern | No | ||
| task_display_name_prefix_pattern | No | ||
| rendered_map_index_prefix_pattern | No |