From 270492b3c5f951c00c04b4b1a2e2fd17b86084ce Mon Sep 17 00:00:00 2001
From: wei-hai <2936715+wei-hai@users.noreply.github.com>
Date: Thu, 23 Jul 2026 15:40:47 +0000
Subject: [PATCH] chore: sync vendored Comfy API v2 spec from cloud@585fbea

---
 spec/openapi.yaml | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/spec/openapi.yaml b/spec/openapi.yaml
index b61746e..7e82d53 100644
--- a/spec/openapi.yaml
+++ b/spec/openapi.yaml
@@ -364,11 +364,7 @@ paths:
                   additionalProperties: true
                 extra_data:
                   type: object
-                  description: >-
-                    Optional, sibling of `workflow` (never nested inside it).
-                    Omit entirely when there is no key to send — an empty
-                    `extra_data` object is not sent by the SDK and should not
-                    be sent by other clients either.
+                  description: 'Per-prompt ComfyUI `extra_data`, same shape as Comfy Cloud and local ComfyUI. Closed object: only the enumerated keys are accepted, keeping the contract fully typed. Forwarded to the worker per-prompt, never persisted, and excluded from idempotency comparison.'
                   additionalProperties: false
                   properties:
                     api_key_comfy_org:
@@ -440,6 +436,8 @@ paths:
           $ref: '#/components/responses/Forbidden'
         '404':
           $ref: '#/components/responses/NotFound'
+        '429':
+          $ref: '#/components/responses/RateLimited'
         '500':
           $ref: '#/components/responses/UpstreamError'
   /api/v2/jobs/{id}/events:
@@ -551,6 +549,8 @@ paths:
           $ref: '#/components/responses/Forbidden'
         '404':
           $ref: '#/components/responses/NotFound'
+        '429':
+          $ref: '#/components/responses/RateLimited'
         '500':
           $ref: '#/components/responses/UpstreamError'
 components:
@@ -619,6 +619,15 @@ components:
         application/json:
           schema:
             $ref: '#/components/schemas/ErrorEnvelope'
+    RateLimited:
+      description: '`rate_limited` — the caller has exceeded the request rate limit for this account. Account/rate-scoped, not job-specific — this can be returned even for a job id the caller doesn''t own or that doesn''t exist, without revealing which.'
+      headers:
+        Retry-After:
+          $ref: '#/components/headers/RetryAfter'
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/ErrorEnvelope'
   schemas:
     Asset:
       type: object