Docs: Tool reference
admin toolset

save_tag

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

FieldTypeDescription
idstringOmit to create a tag; pass to update it.
namestringRequired to create.
colorstringDefaults to gray.
expected_versionintegerThe tag's version from get_workspace_overview. If it changed since, the call fails instead of overwriting a newer change.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
idrequiredstringID with prefix "tag_"
workspace_idrequiredstringID with prefix "ws_"
namerequiredstring
colorrequiredstring
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "save_tag", "arguments": {} }

// Typed client
await carechannel.save_tag({});