# Apache Airflow DAG Run API

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

Apache Airflow DAG Run API 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 DAG Run. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a changelog.

The DAG Run API from Apache Airflow — 6 operation(s) for dag run.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/dags/{dag_id}/dagRuns` | Apache Airflow List DAG Runs |
| POST | `/dags/{dag_id}/dagRuns` | Apache Airflow Trigger a New DAG Run |
| DELETE | `/dags/{dag_id}/dagRuns/{dag_run_id}` | Apache Airflow Delete a DAG Run |
| GET | `/dags/{dag_id}/dagRuns/{dag_run_id}` | Apache Airflow Get a DAG Run |
| PATCH | `/dags/{dag_id}/dagRuns/{dag_run_id}` | Apache Airflow Modify a DAG Run |
| POST | `/dags/{dag_id}/dagRuns/{dag_run_id}/clear` | Apache Airflow Clear a DAG Run |
| PATCH | `/dags/{dag_id}/dagRuns/{dag_run_id}/setNote` | Apache Airflow Update the DagRun Note |
| GET | `/dags/{dag_id}/dagRuns/{dag_run_id}/upstreamDatasetEvents` | Apache Airflow Get Dataset Events for a DAG Run |
| POST | `/dags/~/dagRuns/list` | Apache Airflow List DAG Runs (batch) |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/apache-airflow/refs/heads/main/openapi/apache-airflow-dag-run-api-openapi.yml
- **Documentation** — https://airflow.apache.org/docs/apache-airflow/stable/stable-rest-api-ref.html
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/apache-airflow/refs/heads/main/errors/apache-airflow-problem-types.yml
- **Authentication** — https://airflow.apache.org/docs/apache-airflow/stable/security/api.html
- **ChangeLog** — https://airflow.apache.org/docs/apache-airflow/stable/release_notes.html

## 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

DAG Run

---

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