airflow-hitl

SKILL.md

Human approval gates, form inputs, and branching in Airflow DAGs using deferrable operators.

Four operator types: ApprovalOperator for approve/reject decisions, HITLOperator for multi-option selection with forms, HITLBranchOperator for human-driven task routing, and HITLEntryOperator for form data collection

All operators are deferrable, releasing worker slots while awaiting human response via Airflow UI's Required Actions tab or REST API

Supports optional features including custom notifiers, respondent restrictions by auth manager type, timeout defaults, markdown-templated body text, and standard Airflow callbacks

Requires Airflow 3.1+; not compatible with Airflow 2.x

Airflow Human-in-the-Loop Operators

Pause a DAG until a human responds via the Airflow UI or REST API. HITL operators are deferrable — they release their worker slot while waiting.

Requires Airflow 3.1+ (af config version).

UI location: Browse → Required Actions. Respond from the task instance page's Required Actions tab.

Cross-references: airflow-ai for AI/LLM task decorators; airflow for registry and API discovery commands used below.

Step 1 — Pick the capability you need