How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Apache Airflow DAG API

The DAG API from Apache Airflow — 8 operation(s) for dag.

Apache Airflow DAG API is one of 19 APIs that Apache Airflow publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include DAG. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a changelog.

This API exposes 11 operations across 8 paths, and defines 21 schemas. It is described by OpenAPI 3.2.0, at version 3.0.

Requests are made against 2 base URLs: /api/v1, https://apache.local.

11 operations 8 paths 21 schemas 1 DELETE6 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.0
Base URL
http://localhost:8080/api/v1
Authentication
HTTP Basic, OpenID Connect, HTTP Negotiate
License
Resource Areas
1

Authentication & Security 3

Apache Airflow DAG API declares 3 security schemes for authenticating requests. It accepts HTTP basic authentication (Basic). It supports OpenID Connect (GoogleOpenId) discovered at https://accounts.google.com/.well-known/openid-configuration. It uses HTTP negotiate authentication (Kerberos).

Paths & Operations 11

Across 8 paths, the API surfaces 11 operations — 1 DELETE, 6 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

DAG 11
GET
/dagSources/{file_token}
Apache Airflow Get a Source Code
get_dag_source 1 param → 200401403404406
GET
/dags
Apache Airflow List DAGs
get_dags 6 params → 200401
PATCH
/dags
Apache Airflow Update DAGs
patch_dags 6 params body → 200401403404
DELETE
/dags/{dag_id}
Apache Airflow Delete a DAG
delete_dag 1 param → 204400401403404409
GET
/dags/{dag_id}
Apache Airflow Get Basic Information About a DAG
get_dag 1 param → 200401403404
PATCH
/dags/{dag_id}
Apache Airflow Update a DAG
patch_dag 2 params body → 200401403404
POST
/dags/{dag_id}/clearTaskInstances
Apache Airflow Clear a Set of Task Instances
post_clear_task_instances 1 param body → 200401403404
GET
/dags/{dag_id}/details
Apache Airflow Get a Simplified Representation of DAG
get_dag_details 1 param → 200401403404
GET
/dags/{dag_id}/tasks
Apache Airflow Get Tasks for DAG
get_tasks 2 params → 200401403404
GET
/dags/{dag_id}/tasks/{task_id}
Apache Airflow Get Simplified Representation of a Task
get_task 2 params → 200401403404
POST
/dags/{dag_id}/updateTaskInstancesState
Apache Airflow Set a State of Task Instances
post_set_task_instances_state 1 param body → 200401403404

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are DAG (26 properties), Task (24 properties), RelativeDelta (16 properties), ClearTaskInstances (14 properties). Each schema is shown below with its type and property counts.

Color
string
Color in hexadecimal notation.
UpdateTaskInstancesState
object
9 properties
ClassReference
object
Class reference
2 properties
TaskInstanceReference
object
4 properties
Tag
object
Tag
1 property
DAGDetail
DAG details. For details see: [airflow.models.DAG](https://airflow.apache.org/docs/apache-airflow/stable/api/airflow/models/index.htmlairflow.models.DAG)
CollectionInfo
object
Metadata about collection.
1 property
TriggerRule
string
Trigger rule. Changed in version 2.2.0: 'nonefailedminonesuccess' is added as a possible value.
Error
object
[RFC7807](https://tools.ietf.org/html/rfc7807) compliant response.
5 properties 3 required
TaskInstanceReferenceCollection
object
1 property
TaskCollection
object
Collection of tasks.
1 property
Timezone
string
DAG
object
DAG
26 properties
DAGCollection
object
Collection of DAGs. Changed in version 2.1.0: 'totalentries' field is added.
WeightRule
string
Weight rule.
ScheduleInterval
Schedule interval. Defines how often DAG runs, this object gets added to your latest task instance's executiondate to figure out the next schedule.
TimeDelta
object
Time delta
4 properties 4 required
ClearTaskInstances
object
14 properties
Task
object
For details see: [airflow.models.BaseOperator](https://airflow.apache.org/docs/apache-airflow/stable/api/airflow/models/index.htmlairflow.models.BaseOperator)
24 properties
CronExpression
objectnull
Cron expression
2 properties 2 required
RelativeDelta
object
Relative delta
16 properties 16 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apache-airflow-dag-api-openapi.yml Raw ↑

Other APIs Apache Airflow publishes across the network.

Apache Airflow Experimental API (Deprecated)
Apache Airflow Config API
Apache Airflow Connection API
Apache Airflow DAGRun API
Apache Airflow DagWarning API
Apache Airflow Dataset API
Apache Airflow EventLog API
Apache Airflow ImportError API
Apache Airflow Monitoring API
Apache Airflow Permission API
Apache Airflow Plugin API
Apache Airflow Pool API
Where this information came from

This is an independent, third-party profile of Apache Airflow DAG API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.