From 011c6bf101c23d3f0914575af69f6307eae36287 Mon Sep 17 00:00:00 2001
From: Matt Miller <mattmiller@comfy.org>
Date: Tue, 26 May 2026 14:23:11 -0700
Subject: [PATCH] openapi: add Cloud-runtime fields workflow_id,
 execution_error to JobEntry

The Cloud runtime returns two additional fields on JobEntry that the spec
didn't declare:

- workflow_id: UUID of the Cloud workflow entity the job is associated with
- execution_error: structured ComfyUI execution error for failed jobs
  (reuses the existing ExecutionError schema)

Both tagged x-runtime: [cloud] with [cloud-only] descriptions; local ComfyUI
does not populate them.
---
 openapi.yaml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index e62d0ab67..112ac35b0 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -7565,6 +7565,16 @@ components:
         outputs_count:
           type: integer
           description: Total number of output files
+        workflow_id:
+          type: string
+          nullable: true
+          x-runtime: [cloud]
+          description: "[cloud-only] UUID of the Cloud workflow entity this job is associated with. Local ComfyUI returns null."
+        execution_error:
+          x-runtime: [cloud]
+          description: "[cloud-only] Detailed execution error from ComfyUI for failed jobs. Absent on local ComfyUI."
+          allOf:
+            - $ref: "#/components/schemas/ExecutionError"
 
     JobDetailResponse:
       type: object