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
| Code | When |
|---|---|
not_found | Unknown custom tag, or built-in tag (built-ins are not patchable) |
conflict | Tag is archived — recreate with the same name to restore |
validation_error | Bad description / color |
Archive is not exposed on the Public API.
MCP
Tool: update_tag.