On this page

PATCH/tags/:labelKey

PATCH /tags/:labelKey
X-API-Key: sk_live_...
Content-Type: application/json

Credits: 0
Rate limit: 30 / minute (shared control bucket)

Path: URL-encode labelKey when it contains spaces.


Request

{ "description": "Updated classifier hint for auto-tagging.", "color": "indigo" }

Both fields required. Label / labelKey cannot change.


Response 200

Custom tag object (builtin: false).


Errors

CodeWhen
not_foundUnknown custom tag, or built-in tag (built-ins are not patchable)
conflictTag is archived — recreate with the same name to restore
validation_errorBad description / color

Archive is not exposed on the Public API.


MCP

Tool: update_tag.