airflow_list_task_instances
Retrieve task instances for a specific DAG run to monitor execution status, attempt counts, and access per-attempt log URLs. Filter by state or task IDs and paginate results.
Instructions
List task instances for a DAG run (state, try_number, per-attempt log URL).
Parameters
instance: Instance key (optional)
ui_url: Airflow UI URL to resolve instance/dag/dag_run (optional)
dag_id: DAG identifier
dag_run_id: DAG run identifier
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: Optional list of task states (case-insensitive). When provided, only matching states are returned.
task_ids: Optional list of task identifiers to include.
Returns
Response dict: { "task_instances": [{ "task_id", "state", "try_number", "ui_url" }], "count": int, "total_entries"?: int, "filters"?: { "state": [...], "task_ids": [...] }, "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 | ||
| dag_run_id | No | ||
| limit | No | ||
| offset | No | ||
| state | No | ||
| task_ids | No |