# Apache Airflow Task Instance API (v2)

**Canonical:** https://apis.io/apis/apache-airflow/airflow-task-instance-api/  
**Provider:** Apache Airflow — https://apis.io/providers/apache-airflow/  
**Base URL:** http://localhost:8080/api/v2  
**Documentation:** https://airflow.apache.org/docs/apache-airflow/stable/stable-rest-api-ref.html

Apache Airflow Task Instance API (v2) is one of 45 APIs that [Apache Airflow](https://apis.io/providers/apache-airflow/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Task Instance. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

The Task Instance API from Apache Airflow — 20 operation(s) for task instance.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/links` | Airflow Get Extra Links |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | Airflow Get Task Instance |
| PATCH | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | Airflow Patch Task Instance |
| DELETE | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | Airflow Delete Task Instance |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/listMapped` | Airflow Get Mapped Task Instances |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/dependencies` | Airflow Get Task Instance Dependencies |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/dependencies` | Airflow Get Task Instance Dependencies |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/tries` | Airflow Get Task Instance Tries |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/tries` | Airflow Get Mapped Task Instance Tries |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}` | Airflow Get Mapped Task Instance |
| PATCH | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}` | Airflow Patch Task Instance |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances` | Airflow Get Task Instances |
| PATCH | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances` | Airflow Bulk Task Instances |
| POST | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/list` | Airflow Get Task Instances Batch |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/tries/{task_try_number}` | Airflow Get Task Instance Try Details |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/tries/{task_try_number}` | Airflow Get Mapped Task Instance Try Details |
| POST | `/api/v2/dags/{dag_id}/clearTaskInstances` | Airflow Post Clear Task Instances |
| PATCH | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/dry_run` | Airflow Patch Task Instance Dry Run |
| PATCH | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/dry_run` | Airflow Patch Task Instance Dry Run |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/logs/{try_number}` | Airflow Get Log |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/externalLogUrl/{try_number}` | Airflow Get External Log Url |
| PATCH | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/hitlDetails` | Airflow Update Hitl Detail |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/hitlDetails` | Airflow Get Hitl Detail |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/{map_index}/hitlDetails/tries/{try_number}` | Airflow Get Hitl Detail Try Detail |
| GET | `/api/v2/dags/{dag_id}/dagRuns/{dag_run_id}/hitlDetails` | Airflow Get Hitl Details |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/apache-airflow/refs/heads/main/openapi/airflow-task-instance-api-openapi.yml
- **Documentation** — https://airflow.apache.org/docs/apache-airflow/stable/stable-rest-api-ref.html
- **APIReference** — https://airflow.apache.org/docs/apache-airflow/stable/stable-rest-api-ref.html
- **Authentication** — https://airflow.apache.org/docs/apache-airflow/stable/security/api.html
- **SDKs** — https://pypi.org/project/apache-airflow/
- **SDKs** — https://pypi.org/project/apache-airflow-client/
- **SDKs** — https://github.com/apache/airflow

## Other Apache Airflow APIs (12)

- [Apache Airflow Experimental API (Deprecated)](https://apis.io/apis/apache-airflow/apache-airflow-experimental-api/)
- [Apache Airflow Config API](https://apis.io/apis/apache-airflow/apache-airflow-config-api/)
- [Apache Airflow Connection API](https://apis.io/apis/apache-airflow/apache-airflow-connection-api/)
- [Apache Airflow DAG API](https://apis.io/apis/apache-airflow/apache-airflow-dag-api/)
- [Apache Airflow DagWarning API](https://apis.io/apis/apache-airflow/apache-airflow-dagwarning-api/)
- [Apache Airflow Dataset API](https://apis.io/apis/apache-airflow/apache-airflow-dataset-api/)
- [Apache Airflow Monitoring API](https://apis.io/apis/apache-airflow/apache-airflow-monitoring-api/)
- [Apache Airflow Permission API](https://apis.io/apis/apache-airflow/apache-airflow-permission-api/)
- [Apache Airflow Plugin API](https://apis.io/apis/apache-airflow/apache-airflow-plugin-api/)
- [Apache Airflow Pool API](https://apis.io/apis/apache-airflow/apache-airflow-pool-api/)
- [Apache Airflow Provider API](https://apis.io/apis/apache-airflow/apache-airflow-provider-api/)
- [Apache Airflow Role API](https://apis.io/apis/apache-airflow/apache-airflow-role-api/)

## Tags

Task Instance

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/apache-airflow/airflow-task-instance-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/apache-airflow/.