This is an automated email from the ASF dual-hosted git repository.
kaxilnaik pushed a commit to branch v3-0-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
commit 2af039b4f8ca384b3d96c26d2c22088c4a5364ce
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Thu Jul 10 16:27:55 2025 +0200
[v3-0-test] docs: update public interface doc to reflect airflow.sdk and
AIP-72 (#52197) (#53117)
* docs: update public interface doc to reflect airflow.sdk and AIP-72
- Added a note under "Using Airflow Public Interfaces" to recommend using
`airflow.sdk` as the official interface from Airflow 3.0.
- Referenced AIP-72 and linked related documentation.
- Encouraged users to prefer REST API and Python Client for integrations.
* Update airflow-core/docs/public-airflow-interface.rst
Great
---------
(cherry picked from commit e142ab96a0ecbb953e9fb8ab6d17b4c2a7624aba)
Co-authored-by: N R Navaneet <[email protected]>
Co-authored-by: Jarek Potiuk <[email protected]>
---
airflow-core/docs/public-airflow-interface.rst | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/airflow-core/docs/public-airflow-interface.rst
b/airflow-core/docs/public-airflow-interface.rst
index b0b7cfe5af2..0f685c16cce 100644
--- a/airflow-core/docs/public-airflow-interface.rst
+++ b/airflow-core/docs/public-airflow-interface.rst
@@ -47,6 +47,21 @@ For comprehensive Task SDK documentation, see the `Task SDK
Reference <https://a
Using Airflow Public Interfaces
===============================
+.. note::
+
+ As of **Airflow 3.0**, users should use the ``airflow.sdk`` namespace as
the official **Public Interface**, as defined in `AIP-72
<https://cwiki.apache.org/confluence/display/AIRFLOW/AIP-72+Task+Execution+Interface+aka+Task+SDK>`_.
+
+ Direct interaction with internal modules or the metadata database is not
possible.
+ For stable, production-safe integration, it is recommended to use:
+
+ - The official **REST API**
+ - The **Python Client SDK** (`airflow-client-python`)
+ - The new **Task SDK** (``airflow.sdk``)
+
+ Related docs:
+ - `Release Notes 3.0
<https://airflow.apache.org/docs/apache-airflow/stable/release_notes.html>`_
+ - `Task SDK Overview
<https://airflow.apache.org/docs/apache-airflow/stable/concepts/taskflow.html>`_
+
The following are some examples of the public interface of Airflow:
* When you are writing your own operators or hooks. This is commonly done when
no hook or operator exists for your use case, or when perhaps when one exists
but you need to customize the behavior.
