Module sdk

The Apache Airflow Java SDK — author and run Airflow task implementations in JVM languages.

Language SDK compatibility matrix

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-06-16

DimensionTierSupportedSinceNotes
TaskInstance states
state: successMUST3.3
state: failedMUST3.3
state: up_for_retryMUST3.3RetryTask
state: skippedSHOULDruntime does not emit TaskState skipped yet
state: deferredMAYruntime does not emit DeferTask yet
state: up_for_rescheduleMAYruntime does not emit RescheduleTask yet
state: awaiting_inputMAYruntime does not emit AwaitInputTask yet
state: removedMAY3.3
Runtime capabilities
capability: mixed-lang-stub-targetMUST3.3@task.stub
capability: task-loggingMUST3.3SLF4J + JPL bridged to the task log
capability: xcom-read-writeMUST3.3
capability: connection-readMUST3.3
capability: variable-read-writeMUSTgetVariable only; no write over the comm socket yet
capability: self-contained-bundleMUST3.3Airflow metadata embedded in the jar artifact
capability: retry-policyMAYno task-facing retry-policy API yet
capability: task-state-storeMAYno task-facing state-store API yet
capability: asset-state-storeMAYno task-facing state-store API yet
capability: asset-event-emitMAYruntime does not emit asset events yet
capability: asset-event-readMAYno task-facing asset-event API yet
Native-Dag authoring
capability: native-dag-authoringSHOULDnative Dag authoring not implemented yet
capability: task-argsMUST †n/a
capability: dag-paramsMUST †n/a
capability: taskflow-dependenciesMUST †n/a
capability: branchingSHOULD †n/a
capability: dag-testSHOULD †n/a
capability: task-groupMAY †n/a
capability: dynamic-task-mappingMAY †n/a
capability: asset-inlets-outletsMAY †n/a
capability: asset-schedulingMAY †n/a
capability: object-storeMAY †n/a

Marks: ✓ supported · ✗ not supported · n/a not applicable. A tier marked † applies only when native-dag-authoring is supported.