From 78fcc57e33f4249a612514dacfe47d6430d2fbb1 Mon Sep 17 00:00:00 2001
From: bymyself <cbyrne@comfy.org>
Date: Fri, 18 Jul 2025 13:46:36 -0700
Subject: [PATCH] Update to OpenAPI 3.1.0 and use prefixItems for QueueItem

- Changed OpenAPI version from 3.0.3 to 3.1.0 as suggested in PR review
- Updated QueueItem schema to use prefixItems instead of oneOf for proper tuple representation
- Added items: false to enforce the 5-element tuple structure
- Follows OpenAPI 3.1 best practices for representing fixed-length arrays (tuples)
---
 openapi.yaml | 38 +++++++++++++++++++-------------------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/openapi.yaml b/openapi.yaml
index bad7a4ce3..dad3c0f48 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -1,4 +1,4 @@
-openapi: 3.0.3
+openapi: 3.1.0
 info:
   title: ComfyUI API
   description: 'API for ComfyUI - A powerful and modular UI for Stable Diffusion.
@@ -1139,21 +1139,21 @@ components:
         description: Additional metadata fields
     QueueItem:
       type: array
-      description: Queue item containing execution details
-      items:
-        oneOf:
-          - type: integer
-            description: Queue position number
-          - type: string
-            format: uuid
-            description: Unique prompt identifier
-          - type: object
-            description: Workflow graph with nodes and connections
-            additionalProperties: true
-          - type: object
-            description: Extra metadata (auth tokens, client info, etc.)
-            additionalProperties: true
-          - type: array
-            description: Array of output node IDs
-            items:
-              type: string
+      description: Queue item containing execution details as a tuple [position, prompt_id, prompt, extra_data, outputs_to_execute]
+      prefixItems:
+        - type: number
+          description: Queue position number (lower numbers have higher priority)
+        - type: string
+          format: uuid
+          description: Unique prompt identifier
+        - type: object
+          description: Workflow graph with nodes and connections
+          additionalProperties: true
+        - type: object
+          description: Extra metadata (auth tokens, client info, etc.)
+          additionalProperties: true
+        - type: array
+          description: Array of output node IDs
+          items:
+            type: string
+      items: false