Comfy-Org · stale2000 · Sep 17, 2026 · Sep 17, 2026 · Sep 17, 2026 · Sep 17, 2026
diff --git a/api-reference/v2/overview.mdx b/api-reference/v2/overview.mdx
@@ -2,6 +2,7 @@
 title: "Comfy API v2 Overview"
 sidebarTitle: "Overview"
 description: "Reference for the official Comfy API v2: run ComfyUI workflows from external applications by uploading inputs, submitting jobs, and polling for results."
+keywords: ["ComfyAPI", "Comfy API"]
 ---
 
 <Warning>
@@ -27,7 +28,7 @@
 comfy-api-proxy
 ```

 By default it proxies the ComfyUI on `127.0.0.1:8188` and serves the v2 API on `127.0.0.1:8189`, binding to loopback only. Authentication is off by default, with an optional static bearer token. The proxy is a stopgap: once v2 stabilizes it moves into ComfyUI core and the proxy is no longer needed. See [Your own ComfyUI](/development/api-development/sdks#your-own-comfyui) in the SDK guide for configuration details.

 ## Design Principles

@@ -51,7 +52,7 @@
 | Category | Description |
 |----------|-------------|
 | Assets | UUID-identified records over content-addressed blobs. Upload inputs, download outputs. |
 | Jobs | One execution of a workflow. Durable, pollable, and cancelable. |

 ## Comfy Router


diff --git a/custom-nodes/v3_migration.mdx b/custom-nodes/v3_migration.mdx
@@ -73,7 +73,7 @@

 ## Migration Steps

 Going from V1 to V3 should be simple in most cases and is simply a syntax change.

 ### Step 1: Change Base Class

@@ -207,7 +207,7 @@

 ### Step 5: Handle Special Methods

 The same special methods are supported as in v1, but either lowercased or renamed entirely to be more clear. Their usage remains the same.

 #### Validation (V1 → V3)

@@ -278,7 +278,7 @@

 ### Step 6: Create Extension and Entry Point

 Instead of defining dictionaries to link node id to node class/display name, there is now a ```ComfyExtension``` class and an expected ```comfy_entrypoint``` function to be defined.

 In the future, more functions may be added to ComfyExtension to register more than just nodes via ```get_node_list```.

@@ -347,7 +347,7 @@

 ### ComfyUI Types

 | V1 Type | V3 Type | Example |
 |---------|---------|---------|
 | `"IMAGE"` | `io.Image.Input()` | `io.Image.Input("image", tooltip="Input image")` |
 | `"MASK"` | `io.Mask.Input()` | `io.Mask.Input("mask", optional=True)` |
@@ -381,12 +381,12 @@
 | `display_name` | `str` | `None` | Display name shown in the UI. Falls back to `node_id` if not set. |
 | `category` | `str` | `"sd"` | Category in the "Add Node" menu (e.g. `"image/transform"`). |
 | `description` | `str` | `""` | Tooltip shown when hovering over the node. |
 | `inputs` | `list[Input]` | `[]` | List of input definitions. |
 | `outputs` | `list[Output]` | `[]` | List of output definitions. |
 | `hidden` | `list[Hidden]` | `[]` | List of hidden inputs to request (see [Hidden Inputs](#hidden-inputs)). |
 | `search_aliases` | `list[str]` | `[]` | Alternative names for search. Useful for synonyms or old names after renaming. |
 | `is_output_node` | `bool` | `False` | Marks the node as an output node, causing it and its dependencies to be executed. |
 | `is_input_list` | `bool` | `False` | When True, all inputs become `list[type]` regardless of how many items are passed in. |
 | `is_deprecated` | `bool` | `False` | Flags the node as deprecated, signaling users to find alternatives. |
 | `is_experimental` | `bool` | `False` | Flags the node as experimental, warning users it may change. |
 | `is_dev_only` | `bool` | `False` | Hides the node from search/menus unless dev mode is enabled. |
@@ -505,7 +505,7 @@

 #### Save Helpers

 Save helpers provide methods for saving files to the output directory with proper metadata embedding. They are typically used in output nodes.

 ```python
 from comfy_api.latest import ui, io
@@ -555,7 +555,7 @@
 ```

 <Tip>
 Passing `cls=cls` to save/preview helpers allows them to automatically embed workflow metadata (prompt, extra_pnginfo) in the saved files. Make sure to include `io.Hidden.prompt` and `io.Hidden.extra_pnginfo` in your schema's hidden list, or set `is_output_node=True` which adds them automatically.
 </Tip>

 #### Returning Raw UI Dicts
@@ -699,7 +699,7 @@
 )
 ```

 Autogrow can be combined with MatchType to create lists of type-matched inputs:

 ```python
 @classmethod
@@ -783,7 +783,7 @@

 ### Async Execute

 V3 supports async `execute` methods. This is useful for nodes that perform I/O operations, API calls, or other async work. Simply declare `execute` as `async`:

 ```python
 @classmethod
@@ -792,7 +792,7 @@
     return io.NodeOutput(result)
 ```
 
-### ComfyAPI
+### Comfy API runtime services {#comfyapi}
 
 The `ComfyAPI` class provides access to ComfyUI runtime services like progress reporting and node replacement registration. Import it and create an instance:
 
@@ -858,7 +858,7 @@

 The `old_widget_ids` parameter is important: workflow JSON stores widget values by position index, not by name. This list maps those positional indexes to input IDs so the replacement system can correctly identify widget values during migration.

 For nodes using dynamic inputs (like Autogrow), use dotted paths in the mapping:

 ```python
 input_mapping=[

diff --git a/development/comfy-api/overview.mdx b/development/comfy-api/overview.mdx
@@ -1,10 +1,11 @@
 ---
 title: "Comfy API"
 sidebarTitle: "Overview"
 description: "The public API for running ComfyUI workflows headlessly"
+keywords: ["ComfyAPI", "Comfy API"]
 ---
 
 The public API for running ComfyUI headlessly has evolved over time. For new integrations, use [Comfy API v2](/api-reference/v2/overview). It is supported on open-source ComfyUI (during the beta, via the [API Proxy](/development/comfyui-server/api-proxy)), Comfy Cloud, and [Comfy API deployments on the Developer Platform](/development/serverless/overview). Older versions include the [v1 Cloud API](/development/cloud/overview), which is deprecated.

 <CardGroup cols={2}>
  <Card title="Comfy API v2" icon="cloud" href="/api-reference/v2/overview">

diff --git a/docs.json b/docs.json
@@ -3110,6 +3110,7 @@
                   "development/api-development/workflow-metadata",
                   {
                     "group": "Comfy API Reference",
+                    "boost": 10,
                     "pages": [
                       "development/comfy-api/overview",
                       {