Save a tag. Creates a tag when id is omitted, or renames or recolors the tag with that id. Tags are internal labels for triage, shared by every board and never shown to end users. Names are unique, ignoring case. See current tags in get_workspace_overview. Pass idempotency_key when creating. Nobody is emailed. Managers and owners.
Toolset
admin
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/tags
Behavior
changes dataaccepts idempotency_key
Input
Field
Type
Description
id
string
Omit to create a tag; pass to update it.
name
string
Required to create.
color
string
Defaults to gray.
expected_version
integer
The tag's version from get_workspace_overview. If it changed since, the call fails instead of overwriting a newer change.
idempotency_key
string
Retry-safe key. Repeating a call with the same key returns the first result.