From cae16c91a9680679559150d5b6e8dada07369a1a Mon Sep 17 00:00:00 2001 From: Matt Miller Date: Fri, 8 May 2026 19:07:30 -0700 Subject: [PATCH] spec: document If-None-Match header on conditional GET endpoints Both `getNodeInfoSchema` and `getNodeByID` advertise `ETag` response headers and a `304 Not Modified` response, but the spec didn't declare the `If-None-Match` request header that triggers conditional validation. Adding it as an optional header parameter on both ops so client codegen exposes the conditional-GET pattern. --- openapi.yaml | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/openapi.yaml b/openapi.yaml index fd18f1c6e..d4c9e67ca 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -2580,6 +2580,13 @@ paths: summary: Get pre-rendered node info schema description: "[cloud-only] Returns the static ComfyUI object_info schema, identical for every caller, rendered once at startup with empty model/user-file context. Served by a raw HTTP handler that writes pre-rendered bytes with ETag + Cache-Control validators for RFC 7232 conditional GETs." x-runtime: [cloud] + parameters: + - name: If-None-Match + in: header + required: false + schema: + type: string + description: Entity tag previously returned by this endpoint. When present and matching, the server returns 304 Not Modified. responses: "200": description: Node info schema @@ -2661,6 +2668,12 @@ paths: schema: type: string description: Node class identifier + - name: If-None-Match + in: header + required: false + schema: + type: string + description: Entity tag previously returned by this endpoint. When present and matching, the server returns 304 Not Modified. responses: "200": description: Single node definition