The Apache Airflow Java SDK — author and run Airflow task implementations in JVM languages.
Which Airflow TaskInstance states and capabilities the Java SDK currently supports. The normative meaning of each dimension is defined in the Language SDK conformance specification.
Min. Airflow version: 3.3 · supervisor schema: 2026-10-30
| Dimension | Tier | Supported | Since | Notes |
|---|---|---|---|---|
| TaskInstance states | ||||
state: success | MUST | ✓ | 3.3 | |
state: failed | MUST | ✓ | 3.3 | |
state: up_for_retry | MUST | ✓ | 3.3 | RetryTask |
state: skipped | SHOULD | ✓ | 3.4 | a TriggerDagRun task that skips an existing run |
state: deferred | MAY | ✓ | 3.4 | a TriggerDagRun task that waits with deferrable |
state: up_for_reschedule | MAY | ✗ | – | runtime does not emit RescheduleTask yet |
state: awaiting_input | MAY | ✗ | – | runtime does not emit AwaitInputTask yet |
state: removed | MAY | ✓ | 3.3 | |
| Runtime capabilities | ||||
capability: mixed-lang-stub-target | MUST | ✓ | 3.3 | @task.stub |
capability: taskflow-binding | MUST | ✗ | – | bind @task.stub literal/XCom args to the native handler |
capability: task-logging | MUST | ✓ | 3.3 | SLF4J + JPL bridged to the task log |
capability: xcom-read-write | MUST | ✓ | 3.3 | |
capability: connection-read | MUST | ✓ | 3.3 | |
capability: variable-read-write | MUST | ✓ | 3.3 | |
capability: self-contained-bundle | MUST | ✓ | 3.3 | Airflow metadata embedded in the jar artifact |
capability: retry-policy | MAY | ✗ | – | no task-facing retry-policy API yet |
capability: task-state-store | MAY | ✓ | 3.3 | Client.getTaskStateStore() get/set/delete/clear |
capability: asset-state-store | MAY | ✗ | – | no task-facing state-store API yet |
capability: asset-event-emit | MAY | ✗ | – | runtime does not emit asset events yet |
capability: asset-event-read | MAY | ✗ | – | no task-facing asset-event API yet |
| Native-Dag authoring | ||||
capability: native-dag-authoring | SHOULD | ✓ | 3.4 | |
capability: task-args | MUST † | ✓ | 3.4 | |
capability: dag-params | MUST † | ✗ | – | |
capability: taskflow-dependencies | MUST † | ✓ | 3.4 | |
capability: branching | SHOULD † | ✓ | 3.4 | DagDef.If and DagDef.Switch, or @Airflow.If and @Airflow.Switch |
capability: dag-test | SHOULD † | ✗ | – | |
capability: task-group | MAY † | ✓ | 3.4 | |
capability: dynamic-task-mapping | MAY † | ✗ | – | |
capability: asset-inlets-outlets | MAY † | ✗ | – | |
capability: asset-scheduling | MAY † | ✗ | – | |
capability: object-store | MAY † | ✗ | – |
Marks: ✓ supported · ✗ not supported · n/a not applicable. A tier marked † applies only when native-dag-authoring is supported.