Skip to content

chore: sync Comfy API v2 specification and Comfy Router pages (cloud@333c22c) - #1676

Open
comfy-pr-bot wants to merge 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec
Open

comfy-pr-bot wants to merge 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec

Conversation

@comfy-pr-bot

Copy link
Copy Markdown
Member

Automated sync of the public Comfy API v2 specification used by
the generated API reference, and of the Comfy Router API
pages generated from the Comfy API contract. Source:
cloud@333c22c.

development/comfy-router/reference.mdx is GENERATED - edit the upstream
contract, not this copy. It is regenerated on every sync and an
edit made here is overwritten by the next one.

development/comfy-router/quickstart.mdx and development/comfy-router/limitations.mdx
are hand-written upstream and published verbatim. They are likewise
overwritten on every sync, so edit them upstream. If this is the
first sync that carries one of them, it also needs a navigation
entry in this repository before it renders.

router-schemas/<provider>/<model>.json are the exact
GET /v2/models/{id}/openapi.json documents for every model with an
authored schema; the docs generator
(.github/scripts/snippets/gen-code-pages.ts) reads them. They are
GENERATED and the directory is MIRRORED on every sync, so a document
removed upstream is removed here too - edit the upstream contract,
not these copies.

development/comfy-router/models/**/code.mdx, the provider index
development/comfy-router/models.mdx and the docs.json
entries for them are this repository's OWN derived output: the sync
runs bun run code-pages:gen -- --prune over the documents above and
commits the result, so code-pages is green as opened and no regen
commit is needed on this branch. They are GENERATED and PRUNED - a
page whose model left the catalog is deleted here too.

This is the single rolling sync pull request for the published
Comfy API v2 specification and Comfy Router pages. It lives on
chore/sync-comfy-api-v2-spec, and every later upstream change
force-updates that branch and refreshes this description with the
new source commit — so there is only ever one open sync pull request
here, and its diff is always the current one. Please do not push
commits to this branch; the next sync would overwrite them (it
checks first and fails rather than doing so silently).

The projection strips internal operations and non-public source
annotations, and fails before this pull request can be created if
a known internal marker survives. This pull request is never
auto-merged and requires human review.

@github-actions

Copy link
Copy Markdown

🌐 i18n translation sync reminder

@comfyui-wiki English documentation was updated in this PR. Please complete or schedule translation updates for the following files:

Japanese (ja)

  • ja/development/comfy-router/reference.mdx

Simplified Chinese (zh)

  • zh/development/comfy-router/reference.mdx

Korean (ko)

  • ko/development/comfy-router/reference.mdx

Local sync: npm run translate (see README — Automated translation)

@mintlify

mintlify Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
comfy 🟢 Ready View Preview Sep 14, 2026, 7:21 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants