@@ -816,6 +816,59 @@ structured data (for example to JSON) before storing it.
    takes precedence over the stored value when the Variable is read back. Calling ``setVariable``
    without a description clears any existing description.
 
+.. _java-sdk/asset-state-store:
+
+Asset state store
+-----------------
+
+``client.assetStateStore`` reads and writes the :doc:`asset state store </core-concepts/asset-state-store>`,
+a key-value store that belongs to an asset rather than to a Dag run. A value that one run stores, such as an
+incremental-load watermark, is still there in later runs.
+
+The Java SDK does not receive the inlets and outlets declared on the ``@task.stub``. The task therefore looks
+up the asset itself, by name with ``byName`` or by URI with ``byUri``. Airflow keeps state only for assets
+that a Dag references, so also declare the asset as an inlet of the stub:
+
+.. code-block:: python
+
+    orders = Asset(name="orders", uri="s3://warehouse/orders")
+
+
+    @task.stub(queue="java", inlets=[orders])
+    def load_orders(): ...
+
+.. code-block:: java
+
+    @Builder.TaskHandler(dag = "orders_pipeline", task = "load_orders")
+    public void loadOrders(Client client) {
+      var orders = client.assetStateStore.byName("orders");
+      var watermark = (String) orders.get("watermark"); // null on the first run
+      // Your own code: load the rows created after the watermark and return the newest creation time.
+      String newest = loadRowsCreatedAfter(watermark);
+      orders.set("watermark", newest);
+    }
+
+``get`` returns ``null`` when the key is not set. ``set`` replaces any existing value. Entries do not expire.
+``delete`` removes one key, and ``clear`` removes every key of the asset.
+
+``set`` sends the value as JSON. Store strings, booleans, integers that fit in a ``long``, finite ``double``
+values, lists, and maps with string keys. Jackson converts other objects first. A bean becomes a map of its
+properties, and an ``Instant`` or a ``UUID`` becomes a string. ``null``, ``BigDecimal``, and ``Duration``
+fail with an exception before anything is sent. Never store a ``byte[]``. The supervisor cannot decode it and
+never answers, so the task hangs. Encode binary data as a string instead, for example with Base64.
+
+``get`` returns the Java types listed in :ref:`java-sdk/types`. For example, a value stored as an ``Integer``
+comes back as a ``Long``.
+
+If no Dag references an asset with the name or URI that the task passed, ``get`` returns ``null`` and the
+other methods throw ``ApiError``. Airflow normalizes asset URIs when it parses a Dag, so pass ``byUri`` the
+normalized form. For example, ``s3://warehouse/orders/`` is stored as ``s3://warehouse/orders``.
+
+The Java SDK does not apply a ``[workers] state_store_backend``. It sends each value to Airflow as-is. A key
+that a Python task stored through such a backend comes back to Java as a map that holds only the reference
+under ``__airflow_state_ref__``, not the stored value. Deleting or clearing such a key from Java removes only
+that reference, and the stored value stays in the backend.
+
 .. _java-sdk/build:
 
 Building and packaging
 
@@ -20,12 +20,15 @@
 package org.apache.airflow.e2e;
 
 import java.util.List;
+import java.util.Map;
+import java.util.Objects;
 import org.apache.airflow.sdk.*;
 import org.jetbrains.annotations.NotNull;
 
 /**
  * Bundle for the runner-behaviour E2E tests: deliberately broken task classes that exercise
- * instantiation failures, and a task that round-trips Airflow Variables through the supervisor.
+ * instantiation failures, and tasks that round-trip Airflow Variables and asset state through the
+ * supervisor.
  */
 public class TestBundleBuilder implements BundleBuilder {
   public static class MissingNoArgConstructor implements Task {
@@ -60,6 +63,46 @@ public void execute(@NotNull Context context, Client client) {
     }
   }
 
+  /**
+   * Calls every asset state store method on one asset, through a lookup by name and a lookup by
+   * URI. Each step changes the state through one lookup and checks the result through the other,
+   * so the task fails unless both lookups reach the same asset. The E2E test then reads the
+   * remaining keys through the REST API.
+   */
+  public static class UseAssetStateStore implements Task {
+    public void execute(@NotNull Context context, Client client) {
+      var byName = client.assetStateStore.byName("java_e2e_orders");
+      var byUri = client.assetStateStore.byUri("x-java-e2e://orders");
+
+      byName.set("scratch", "first");
+      expect("first", byUri.get("scratch"), "set() through the name");
+      byUri.clear();
+      expect(null, byName.get("scratch"), "clear() through the URI");
+
+      byUri.set("scratch", "second");
+      expect("second", byName.get("scratch"), "set() through the URI");
+      byName.clear();
+      expect(null, byUri.get("scratch"), "clear() through the name");
+
+      byName.set("deleted", "temporary");
+      byUri.delete("deleted");
+      expect(null, byName.get("deleted"), "delete() through the URI");
+      byUri.set("deleted", "temporary");
+      byName.delete("deleted");
+      expect(null, byUri.get("deleted"), "delete() through the name");
+
+      var summary = Map.of("run_id", context.dagRun.runId, "rows", 3L);
+      byName.set("summary", summary);
+      expect(summary, byUri.get("summary"), "set() through the name, with a map value");
+    }
+
+    private static void expect(Object expected, Object actual, String step) {
+      if (!Objects.equals(expected, actual)) {
+        throw new IllegalStateException(step + ": expected " + expected + " but read " + actual);
+      }
+    }
+  }
+
   @NotNull
   @Override
   public Iterable<DagDef> getDags() {
@@ -68,7 +111,9 @@ public Iterable<DagDef> getDags() {
     uninstantiable.addTask("non_static_inner", NonStaticInner.class);
     var variableWrite = new DagDef("java_variable_write");
     variableWrite.addTask("write_and_delete", WriteAndDeleteVariable.class);
-    return List.of(uninstantiable, variableWrite);
+    var assetStateStore = new DagDef("java_asset_state_store");
+    assetStateStore.addTask("use_asset_state_store", UseAssetStateStore.class);
+    return List.of(uninstantiable, variableWrite, assetStateStore);
   }
 
   public static void main(String[] args) {
 
@@ -18,7 +18,7 @@
 
 from __future__ import annotations
 
-from airflow.sdk import dag, task
+from airflow.sdk import Asset, dag, task
 
 
 @task.stub(queue="java-test")
@@ -48,3 +48,20 @@ def java_variable_write():
 
 
 java_variable_write()
+
+
+# The Java task cannot see this inlet. Declaring it keeps the asset active, and the
+# Execution API only reads and writes the state of active assets.
+java_e2e_orders = Asset(name="java_e2e_orders", uri="x-java-e2e://orders")
+
+
+@task.stub(queue="java-test", inlets=[java_e2e_orders])
+def use_asset_state_store(): ...
+
+
+@dag(dag_id="java_asset_state_store")
+def java_asset_state_store():
+    use_asset_state_store()
+
+
+java_asset_state_store()
@@ -163,6 +163,14 @@ def get_variable(self, key: str):
         """Get an Airflow Variable via API."""
         return self._make_request(method="GET", endpoint=f"variables/{key}")
 
+    def get_asset_state_store_entry(self, asset_name: str, key: str):
+        """Get one key of an asset's state store via API, looking up the asset by its name."""
+        # name_pattern matches substrings, so keep only the asset named exactly asset_name.
+        assets = self._make_request(method="GET", endpoint="assets", params={"name_pattern": asset_name})
+        asset_ids = [asset["id"] for asset in assets["assets"] if asset["name"] == asset_name]
+        assert len(asset_ids) == 1, f"expected one asset named {asset_name!r}, got {assets!r}"
+        return self._make_request(method="GET", endpoint=f"assets/{asset_ids[0]}/state-store/{key}")
+
     def trigger_dag_and_wait(self, dag_id: str, json=None):
         """Trigger a DAG and wait for it to complete."""
         self.un_pause_dag(dag_id)
 
@@ -95,6 +95,9 @@
 _SCALA_SPARK_DAG_ID = "scala_spark_example"
 _VARIABLE_WRITE_DAG_ID = "java_variable_write"
 _VARIABLE_WRITE_DESCRIPTION = "written by the Java SDK e2e test"
+_ASSET_STATE_STORE_DAG_ID = "java_asset_state_store"
+_ASSET_STATE_STORE_TASK_ID = "use_asset_state_store"
+_ASSET_STATE_STORE_ASSET_NAME = "java_e2e_orders"
 
 
 @dataclass
@@ -205,6 +208,12 @@ def variable_write_run() -> _CompletedRun:
     return _trigger_and_wait_for_dag(_VARIABLE_WRITE_DAG_ID, _JAVA_TASK_TIMEOUT)
 
 
+@pytest.fixture(scope="module")
+def asset_state_store_run() -> _CompletedRun:
+    """Trigger the asset state store Dag once for all of its assertions."""
+    return _trigger_and_wait_for_dag(_ASSET_STATE_STORE_DAG_ID, _JAVA_TASK_TIMEOUT)
+
+
 class TestJavaSDKAnnotationExample:
     """Verify the annotation-based Java SDK example executes correctly."""
 
@@ -406,6 +415,56 @@ def test_scratch_variable_deleted_by_java_task_is_gone(self, variable_write_run:
         )
 
 
+class TestJavaSDKAssetStateStore:
+    """Verify a Java task can read and write the state store of an asset.
+
+    The task lives in the java-test-bundle fixture project (served on the
+    dedicated "java-test" queue). It looks up the ``java_e2e_orders`` asset both
+    by name and by URI and calls every asset state store method. Each step
+    changes the state through one lookup and checks it through the other, so the
+    task fails unless both lookups reach the same asset. It leaves the
+    ``summary`` key behind for the REST API to read.
+    """
+
+    def _assert_task_succeeded(self, run: _CompletedRun) -> None:
+        ti = run.get_task_instance(_ASSET_STATE_STORE_TASK_ID)
+        assert ti.get("state") == "success", (
+            f"Java {_ASSET_STATE_STORE_TASK_ID!r} task did not succeed.\n"
+            f"  task state : {ti.get('state')!r}\n"
+            f"  dag state  : {run.state!r}\n"
+            f"  all tasks  : {run.ti_states}"
+        )
+
+    def test_value_written_by_java_task_is_readable(self, asset_state_store_run: _CompletedRun):
+        """The value set from Java is stored on the asset and attributed to the Java task."""
+        self._assert_task_succeeded(asset_state_store_run)
+
+        entry = asset_state_store_run.client.get_asset_state_store_entry(
+            _ASSET_STATE_STORE_ASSET_NAME, "summary"
+        )
+        assert entry["value"] == {"run_id": asset_state_store_run.run_id, "rows": 3}, (
+            f"summary should hold the map the Java task stored in this run, got {entry!r}"
+        )
+        assert entry["last_updated_by"] == {
+            "kind": "task",
+            "dag_id": _ASSET_STATE_STORE_DAG_ID,
+            "run_id": asset_state_store_run.run_id,
+            "task_id": _ASSET_STATE_STORE_TASK_ID,
+            "map_index": -1,
+        }, f"summary should be attributed to the Java task, got {entry!r}"
+
+    def test_key_deleted_by_java_task_is_gone(self, asset_state_store_run: _CompletedRun):
+        """A key written and then deleted from Java no longer exists."""
+        self._assert_task_succeeded(asset_state_store_run)
+
+        with pytest.raises(requests.HTTPError) as excinfo:
+            asset_state_store_run.client.get_asset_state_store_entry(_ASSET_STATE_STORE_ASSET_NAME, "deleted")
+        assert excinfo.value.response.status_code == HTTPStatus.NOT_FOUND, (
+            f"the 'deleted' key should have been deleted by the Java task, "
+            f"got HTTP {excinfo.value.response.status_code}"
+        )
+
+
 class TestJavaSDKInterfaceExample:
     """Verify tasks written against ``InputTask`` receive their bound arguments."""
 
 
@@ -615,7 +615,7 @@ prek hook regenerate it.
 | 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 | ✗ | – | no task-facing state-store API yet |
-| capability: `asset-state-store` | MAY | ✗ | – | no task-facing state-store API yet |
+| capability: `asset-state-store` | MAY | ✓ | 3.4 | Client.assetStateStore, by asset name or URI |
 | 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** |  |  |  |  |
 
@@ -86,8 +86,9 @@ capabilities:
     supported: false
     note: "no task-facing state-store API yet"
   asset-state-store:
-    supported: false
-    note: "no task-facing state-store API yet"
+    supported: true
+    since: "3.4"
+    note: "Client.assetStateStore, by asset name or URI"
   asset-event-emit:
     supported: false
     note: "runtime does not emit asset events yet"
 
@@ -52,7 +52,7 @@ meaning of each dimension is defined in the
 | 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 | ✗ | – | no task-facing state-store API yet |
-| capability: `asset-state-store` | MAY | ✗ | – | no task-facing state-store API yet |
+| capability: `asset-state-store` | MAY | ✓ | 3.4 | Client.assetStateStore, by asset name or URI |
 | 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** |  |  |  |  |