Merge fd17b95e1c into 65045730a6

openapi.yaml

@@ -349,6 +349,35 @@ paths:
         "404":
           description: Job not found
 
+  /api/job/{job_id}/status:
+    get:
+      operationId: getJobStatus
+      tags: [queue]
+      summary: Get job status (legacy singular path)
+      x-runtime: [cloud]
+      deprecated: true
+      description: |
+        **Deprecated.** This endpoint is superseded by `GET /api/jobs/{job_id}`.
+        Clients should migrate; the endpoint is retained for backward
+        compatibility but will be removed in a future release.
+      parameters:
+        - name: job_id
+          in: path
+          description: The job ID to fetch status for.
+          required: true
+          schema:
+            type: string
+            format: uuid
+      responses:
+        "200":
+          description: Job status
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JobDetailResponse"
+        "404":
+          description: Job not found
+
   # ---------------------------------------------------------------------------
   # History
   # ---------------------------------------------------------------------------
@@ -436,6 +465,75 @@ paths:
                 additionalProperties:
                   $ref: "#/components/schemas/HistoryEntry"
 
+  /api/history_v2:
+    get:
+      operationId: getHistoryV2
+      tags: [history]
+      summary: Get execution history (v2 format)
+      x-runtime: [cloud]
+      deprecated: true
+      description: |
+        **Deprecated.** This endpoint is superseded by `GET /api/jobs`.
+        Clients should migrate; the endpoint is retained for backward
+        compatibility but will be removed in a future release.
+      parameters:
+        - $ref: "#/components/parameters/ComfyUserHeader"
+        - name: limit
+          in: query
+          schema:
+            type: integer
+          description: Maximum number of history entries to return
+        - name: offset
+          in: query
+          schema:
+            type: integer
+            default: 0
+          description: Pagination offset
+      responses:
+        "200":
+          description: History entries
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/HistoryEntry"
+                  pagination:
+                    $ref: "#/components/schemas/PaginationInfo"
+
+  /api/history_v2/{prompt_id}:
+    get:
+      operationId: getHistoryV2ByPromptId
+      tags: [history]
+      summary: Get v2 history for a specific prompt
+      x-runtime: [cloud]
+      deprecated: true
+      description: |
+        **Deprecated.** This endpoint is superseded by `GET /api/jobs/{prompt_id}`.
+        Clients should migrate; the endpoint is retained for backward
+        compatibility but will be removed in a future release.
+      parameters:
+        - $ref: "#/components/parameters/ComfyUserHeader"
+        - name: prompt_id
+          in: path
+          description: The prompt ID to fetch history for.
+          required: true
+          schema:
+            type: string
+            format: uuid
+      responses:
+        "200":
+          description: Single history entry
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/HistoryEntry"
+        "404":
+          description: Prompt not found
+
   # ---------------------------------------------------------------------------
   # Upload
   # ---------------------------------------------------------------------------
@@ -592,6 +690,71 @@ paths:
         "404":
           description: File not found
 
+  /api/viewvideo:
+    get:
+      operationId: viewVideo
+      tags: [view]
+      summary: View or download a video file (legacy alias)
+      x-runtime: [cloud]
+      deprecated: true
+      description: |
+        **Deprecated.** This endpoint is an alias of `GET /api/view` added for
+        legacy history-queue video playback. Callers should use `/api/view`
+        directly; the endpoint is retained for backward compatibility but will
+        be removed in a future release.
+      parameters:
+        - name: filename
+          in: query
+          required: true
+          schema:
+            type: string
+          description: Name of the file to view
+        - name: type
+          in: query
+          schema:
+            type: string
+            enum: [input, output, temp]
+            default: output
+          description: Directory type
+        - name: subfolder
+          in: query
+          schema:
+            type: string
+          description: Subfolder within the directory
+        - name: preview
+          in: query
+          schema:
+            type: string
+          description: Preview format hint (e.g. "webp;90")
+        - name: channel
+          in: query
+          schema:
+            type: string
+            enum: [rgba, rgb, a]
+          description: Channel extraction mode
+      responses:
+        "200":
+          description: File content
+          content:
+            image/*:
+              schema:
+                type: string
+                format: binary
+            video/*:
+              schema:
+                type: string
+                format: binary
+            audio/*:
+              schema:
+                type: string
+                format: binary
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
+        "404":
+          description: File not found
+
   /api/view_metadata/{folder_name}:
     get:
       operationId: viewMetadata
@@ -692,6 +855,32 @@ paths:
                     x-runtime: [cloud]
                     description: "[cloud-only] How the templates version was resolved. Local ComfyUI returns null."
 
+  /api/logs:
+    get:
+      operationId: getLogs
+      tags: [system]
+      summary: Get server logs (placeholder)
+      x-runtime: [cloud]
+      deprecated: true
+      description: |
+        **Deprecated.** This endpoint returns a static placeholder response and
+        provides no real log data. It is retained only to avoid breaking clients
+        that still call it. Clients should remove their dependency; the endpoint
+        will be removed in a future release.
+      responses:
+        "200":
+          description: Static placeholder log response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  logs:
+                    type: array
+                    items:
+                      type: string
+                    description: Log lines (always empty in current implementation)
+
   # ---------------------------------------------------------------------------
   # Node / Object Info
   # ---------------------------------------------------------------------------