List all tags

Retrieves a list of all tags used across assets. Includes usage counts and filtering options.

GET /api/tags

List all tags

cURL

curl --request GET \
  --url https://cloud.comfy.org/api/tags \
  --header 'X-API-Key: <api-key>'

200

{
  "tags": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "total": 123,
  "has_more": true
}

Authorizations

X-API-Key · string · header · required

API key authentication. Generate an API key from your account settings at https://platform.comfy.org/profile/api-keys. Pass the key in the X-API-Key header.

Query Parameters

prefix · string

Filter tags by prefix

limit · integer · default: 100

Maximum number of tags to return (1-1000)

Required range: 1 <= x <= 1000

offset · integer · default: 0

Number of tags to skip for pagination

Required range: x >= 0

order · enum<string> · default: count_desc

Sort order for tags

Available options: count_desc, name_asc

include_zero · boolean · default: false

Include tags with zero usage count

include_public · boolean · default: true

Whether to include public/shared assets when counting tags

Response

200

application/json

Tags retrieved successfully

tags · object[] · required

List of tags

Show child attributes

total · integer · required

Total number of tags

has_more · boolean · required

Whether more tags are available