Skip to main content
GET
/
v1
/
template
List Templates
curl --request GET \
  --url https://api.comfycontrol.app/v1/template \
  --header 'Authorization: Bearer <token>'
{
  "401": {},
  "templates": [
    {}
  ],
  "total": 123,
  "templates[].id": "<string>",
  "templates[].user_id": "<string>",
  "templates[].name": "<string>",
  "templates[].description": "<string>",
  "templates[].created_at": "<string>",
  "templates[].updated_at": "<string>"
}

​
Overview

Retrieve all templates created by your account with pagination support. Results are ordered by creation date (newest first).

​
Query Parameters

​
page
integer
Page number to retrieve (default: 1, minimum: 1).
​
per_page
integer
Number of templates per page (default: 10, minimum: 1, maximum: 100).

​
Response

​
templates
array
required
Array of template objects.
​
total
integer
required
Total number of templates across all pages.

​
Template Object

​
templates[].id
string
required
Unique identifier (UUID) for the template.
​
templates[].user_id
string
required
UUID of the user who owns this template.
​
templates[].name
string
required
The template’s name.
​
templates[].description
string
required
The template’s description.
​
templates[].created_at
string
required
ISO 8601 timestamp when the template was created.
​
templates[].updated_at
string
required
ISO 8601 timestamp when the template was last updated.

​
Example Response

{
  "templates": [
    {
      "id": "t1e2m3p4-l5a6-7890-abcd-ef1234567890",
      "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Text to Image - Standard",
      "description": "Basic text-to-image generation with SDXL",
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-01-15T10:00:00Z"
    }
  ],
  "total": 1
}

​
Error Responses

​
401
error
Unauthorized - invalid or missing authentication token.

​
Notes

  • Results are ordered by creation date (newest first)
  • Use pagination for accounts with many templates
  • The total field indicates the total count across all pages