Skip to main content
Update Template
curl --request PUT \
  --url https://api.comfycontrol.app/v1/template/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'
{
  "400": {},
  "401": {},
  "404": {},
  "id": "<string>",
  "user_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "body": {},
  "created_at": "<string>",
  "updated_at": "<string>"
}

​
Overview

Update the name, description, or workflow definition of an existing template.
The API playground does not support file uploads. Use cURL, Postman, or your application code to test this endpoint.

​
Content Type

This endpoint requires multipart/form-data content type.

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the template to update.

​
Request Parameters

​
name
string
A new descriptive name for your template (1-100 characters).
​
description
string
A new description of what this template does (1-500 characters).
​
body
file
A JSON file containing the updated ComfyUI workflow definition.

​
Response

​
id
string
required
Unique identifier (UUID) for the template.
​
user_id
string
required
UUID of the user who owns this template.
​
name
string
required
The template’s updated name.
​
description
string
required
The template’s updated description.
​
body
object
required
The updated ComfyUI workflow definition as a JSON object.
​
created_at
string
required
ISO 8601 timestamp when the template was created.
​
updated_at
string
required
ISO 8601 timestamp when the template was last updated.

​
Example Response

{
  "id": "t1e2m3p4-l5a6-7890-abcd-ef1234567890",
  "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Text to Image - Updated",
  "description": "Updated text-to-image generation with SDXL and LoRA",
  "body": {
    "nodes": [...],
    "links": [...],
    "config": {...}
  },
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-15T14:30:00Z"
}

​
cURL Example

Since the API playground doesn’t support file uploads, use this cURL command to test: 
curl -X PUT https://api.comfycontrol.app/v1/template/{id} \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "name=Updated Template Name" \
  -F "description=Updated description" \
  -F "body=@/path/to/updated-workflow.json"
Replace:
  • {id} with the template UUID
  • YOUR_API_TOKEN with your actual API token
  • /path/to/updated-workflow.json with the path to your updated workflow JSON file
  • Only include the fields you want to update (all are optional)
The -F flag automatically handles multipart/form-data with proper boundaries.

​
Error Responses

​
400
error
Bad request - validation error in the request.Common causes:
  • Name or description too long
  • Invalid JSON in body file
​
401
error
Unauthorized - invalid or missing authentication token.
​
404
error
Not Found - template with the specified ID does not exist or does not belong to your account.

​
Notes

  • All fields in the request body are optional - only include fields you want to update
  • Omitted fields will retain their current values
  • Updating a template does not affect workflows that were already created using it
  • Use cURL, Postman, or application code for testing - the API playground doesn’t support file uploads