Create a new custom node

OpenAPI

````yaml https://api.comfy.org/openapi post /publishers/{publisherId}/nodes openapi: 3.0.2 info: title: Comfy API version: '1.0' servers:

url: https://api.comfy.org security: [] tags:
description: Comfy Router's canonical, model-ID-addressed routes. name: Comfy Router
description: >- Signed-in users running Comfy-owned serverless apps with free runs and flat or per-second pricing (FE-2737). name: App Proxy paths: /publishers/{publisherId}/nodes: post: tags:
Registry summary: Create a new custom node operationId: CreateNode parameters:
in: path name: publisherId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/Node' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/Node' description: Node created successfully '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad request, invalid input data. '401': description: Unauthorized '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal server error security:
BearerAuth: [] components: schemas: Node: properties: author: type: string banner_url: description: URL to the node's banner. type: string category: deprecated: true description: >- DEPRECATED: The category of the node. Use 'tags' field instead. This field will be removed in a future version. type: string created_at: description: The date and time when the node was created format: date-time type: string description: type: string downloads: description: The number of downloads of the node. type: integer github_stars: description: Number of stars on the GitHub repository. type: integer icon: description: URL to the node's icon. type: string id: description: The unique identifier of the node. type: string latest_version: $ref: '#/components/schemas/NodeVersion' license: description: The path to the LICENSE file in the node's repository. type: string name: description: The display name of the node. type: string preempted_comfy_node_names: description: A list of Comfy node names that are preempted by this node. items: type: string type: array publisher: $ref: '#/components/schemas/Publisher' rating: description: The average rating of the node. type: number repository: description: URL to the node's repository. type: string search_ranking: description: >- A numerical value representing the node's search ranking, used for sorting search results. type: integer status: $ref: '#/components/schemas/NodeStatus' status_detail: description: The status detail of the node. type: string supported_accelerators: description: >- List of accelerators (e.g. CUDA, DirectML, ROCm) that this node supports items: type: string type: array supported_comfyui_frontend_version: description: Supported versions of ComfyUI frontend type: string supported_comfyui_version: description: Supported versions of ComfyUI type: string supported_os: description: List of operating systems that this node supports items: type: string type: array tags: items: type: string type: array tags_admin: description: Admin-only tags for security warnings and admin metadata items: type: string type: array translations: additionalProperties: additionalProperties: true type: object description: Translations of node metadata in different languages. type: object type: object ErrorResponse: properties: error: type: string message: type: string required:
error
message type: object NodeVersion: properties: changelog: description: Summary of changes made in this version type: string comfy_node_extract_status: description: The status of comfy node extraction process. type: string createdAt: description: The date and time the version was created. format: date-time type: string dependencies: description: A list of pip dependencies required by the node. items: type: string type: array deprecated: description: Indicates if this version is deprecated. type: boolean downloadUrl: description: '[Output Only] URL to download this version of the node' type: string id: type: string node_id: description: The unique identifier of the node. type: string status: $ref: '#/components/schemas/NodeVersionStatus' status_reason: type: string supported_accelerators: description: >- List of accelerators (e.g. CUDA, DirectML, ROCm) that this node supports items: type: string type: array supported_comfyui_frontend_version: description: Supported versions of ComfyUI frontend type: string supported_comfyui_version: description: Supported versions of ComfyUI type: string supported_os: description: List of operating systems that this node supports items: type: string type: array tags: items: type: string type: array tags_admin: description: >- Admin-only tags for security warnings and admin metadata. Read-only for publishers - omitted from all public responses and ignored if sent on publish; only returned on admin-authenticated responses. items: type: string type: array version: description: >- The version identifier, following semantic versioning. Must be unique for the node. type: string type: object Publisher: properties: createdAt: description: The date and time the publisher was created. format: date-time type: string description: type: string id: description: >- The unique identifier for the publisher. It's akin to a username. Should be lowercase. type: string logo: description: URL to the publisher's logo. type: string members: description: A list of members in the publisher. items: $ref: '#/components/schemas/PublisherMember' type: array name: type: string source_code_repo: type: string status: $ref: '#/components/schemas/PublisherStatus' support: type: string website: type: string type: object NodeStatus: enum:
NodeStatusActive
NodeStatusDeleted
NodeStatusBanned type: string NodeVersionStatus: enum:
NodeVersionStatusActive
NodeVersionStatusDeleted
NodeVersionStatusBanned
NodeVersionStatusPending
NodeVersionStatusFlagged type: string PublisherMember: properties: id: description: The unique identifier for the publisher member. type: string role: description: The role of the user in the publisher. type: string user: $ref: '#/components/schemas/PublisherUser' type: object PublisherStatus: enum:
PublisherStatusActive
PublisherStatusBanned type: string PublisherUser: properties: email: description: The email address for this user. type: string id: description: The unique id for this user. type: string name: description: The name for this user. type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: >- Bearer token authentication. Normally a Firebase or Cloud JWT. A 'comfyui-' prefixed API key is also accepted in this header: the prefix classifies the value as an API key and it is validated exactly as if it had been sent in X-API-Key.

Accepted on the operations served by the comfyFirebase auth middleware (BE-9720, parity with ingest). scheme: bearer type: http

````