jason810496 commented on code in PR #53346: URL: https://github.com/apache/airflow/pull/53346#discussion_r2320674557
########## airflow-core/docs/core-concepts/dag-run.rst: ########## @@ -260,6 +260,28 @@ Example of a parameterized DAG: **Note**: The parameters from ``dag_run.conf`` can only be used in a template field of an operator. +Wait for a DAG Run Review Comment: ```suggestion Wait for a Dag Run ``` ########## airflow-core/docs/core-concepts/dag-run.rst: ########## @@ -260,6 +260,28 @@ Example of a parameterized DAG: **Note**: The parameters from ``dag_run.conf`` can only be used in a template field of an operator. +Wait for a DAG Run +------------------ + +Airflow provides an experimental API to **wait for a DAG run to complete**. This is particularly useful when integrating Airflow into external systems or automation pipelines that need to pause execution until a DAG finishes. + +The endpoint blocks (by polling) until the specified DAG run reaches a terminal state: ``success``, ``failed``, or ``canceled``. + +This endpoint streams responses using the **NDJSON (Newline-Delimited JSON)** format. Each line in the response is a JSON object representing the state of the DAG run at that moment. Review Comment: ```suggestion Airflow provides an experimental API to **wait for a Dag run to complete**. This is particularly useful when integrating Airflow into external systems or automation pipelines that need to pause execution until a Dag finishes. The endpoint blocks (by polling) until the specified Dag run reaches a terminal state: ``success``, ``failed``, or ``canceled``. This endpoint streams responses using the **NDJSON (Newline-Delimited JSON)** format. Each line in the response is a JSON object representing the state of the Dag run at that moment. ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
