From 2eb15b62373d156cf50626bddd0dfc0e401c2076 Mon Sep 17 00:00:00 2001
From: Matt Miller <mattmiller@comfy.org>
Date: Wed, 20 May 2026 11:11:26 -0700
Subject: [PATCH] spec(assets): document optional id field on ResultItem

ExecutedWsMessage's per-entry shape (ResultItem) now optionally carries
the asset reference UUID when --enable-assets is set.
---
 openapi.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

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