We currently have one [experimental API|https://airflow.readthedocs.io/en/latest/rest-api-ref.html], but despite its existence for 2 years, it has not reached a stable level.

The Polidea and Google teams together with the community want to make another attempt based on our and community experience. Airflow deserves new stable solutions.

Details are available in the AIP:

This is the first ticket regarding AIP-32 on Github. I will try to update it regularly to inform you about the high-level status of this task.

We have merged spec. You could preview it using the following links:
Swaagger UI:
https://editor.swagger.io/?url=https://raw.githubusercontent.com/apache/airflow/master/airflow/api_connexion/openapi/v1.yaml
Redoc:
https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/apache/airflow/master/airflow/api_connexion/openapi/v1.yaml

This task consists of the following areas:

• API Endpoints
• Docs for REST API

In addition, we have the following tasks:

• Basic OpenAPI spec
• Basic integration Airflow and connexion
• (de)serialization for Python objects
• (de)serialization common objects
• (de)serialziation for SQLAlchemy objects
• HATEOS for API
• CRUD Framework for API
• Authorization and Permissions
• Authentication in API
• Custom WEB UI screen to control permissions
• API security tests

Resources:

AIP-32 on Wiki:
https://cwiki.apache.org/confluence/display/AIRFLOW/AIP-32%3A+Airflow+REST+API
Discussion about AIP on the mailing list:
https://lists.apache.org/thread.html/rbcee49452f1e2714fbdb91f12cfcb115d24681d01ccb6a3845a7e699%40%3Cdev.airflow.apache.org%3E
Voting: on the mailing list
https://lists.apache.org/thread.html/rcc379dc7067397e1a631c19b9f194f2f572a2ea7a338648788911c91%40%3Cdev.airflow.apache.org%3E

Contribution

We invite everyone to contribute. We have #sig-api to decisions and to coordinate our work.
Registration link: https://apache-airflow-slack.herokuapp.com/
All changes are labelled "area:API" on Github.
Information about current tasks are available on Github Project: https://github.com/apache/airflow/projects/1