diff --git a/openapi.yaml b/openapi.yaml
index 2658b9b86..a086a1a1b 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -6569,6 +6569,13 @@ components:
           enum: [input, output, temp]
         display_name:
           type: string
+        id:
+          type: string
+          format: uuid
+          description: |
+            Asset reference UUID. Present only when the server is started with
+            `--enable-assets` and the file resolves to a registered asset.
+            Fetch the full asset via `GET /api/assets/{id}`.
 
     NodeOutputs:
       type: object