Repository navigation
chore: sync Comfy API v2 specification and Comfy Router pages (cloud@401d01eb) - #2166
Merged
Merged
Conversation
|
Important Review skippedBot user detected. To trigger a single review, invoke the
 |
Contributor
🌐 i18n translation sync checkEnglish docs changed in this PR. 28 files in 4 languages may not be synced yet. The automated translation workflow handles these updates. Expand a language to see the files. Japanese (
|
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
cloud-code-bot
Bot
force-pushed
the
chore/sync-comfy-api-v2-spec
branch
from
October 28, 2026 22:12
319bf70 to
2774151
Compare
cloud-code-bot
Bot
changed the title
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Automated sync of the public Comfy API v2 and Comfy Router specifications used by the generated API references, and of the Comfy Router API pages generated from the Comfy API contract. Source:
cloud@401d01eb.router-openapi.yamlis the public Comfy Router contract, projected from the same upstream contract the Router pages are generated from and the same projection the Router SDKs vendor (the Python and Swift copies byte-for-byte; the TypeScript SDK reformats its copy with oxfmt). It is GENERATED - edit the upstream contract, not this copy. If this is the first sync that carries it, it renders nothing until this repository gives it anopenapi:navigation entry.development/comfy-router/reference.mdxis 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,development/comfy-router/limitations.mdx,development/comfy-router/pricing.mdx,development/comfy-router/higgsfield-byok.mdxanddevelopment/comfy-router/litellm.mdxare 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>.jsonare the exactGET /v2/models/{id}/openapi.jsondocuments 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 model indexdevelopment/comfy-router/models.mdx, the serving-provider indexdevelopment/comfy-router/providers.mdxand thedocs.jsonentries for them are this repository's OWN derived output: the sync runsbun run code-pages:gen -- --pruneover the documents above and commits the result, socode-pagesis 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, andproviders.mdxexists only while some model publishes anx-comfy-router-alt-providersleg.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. When this repository's
DOCS_SYNC_AUTOMERGEvariable istrue,.github/workflows/sync-pr-automerge.ymlsquash-merges it once every check has finished green; otherwise it waits for human review.