Docs: Tool reference
admin toolset

delete_tag

Delete a tag. Deletes a tag and takes it off every post that has it. Destructive: pass confirm: true, or dry_run: true to preview. Nobody is emailed. Managers and owners.

Toolset
admin
Who can call it
OwnersManagersAPI keys
REST
DELETE /api/v1/w/{workspace}/tags/{tag}
Behavior
changes datadestructive (confirm: true, dry_run)

Input

FieldTypeDescription
tagrequiredstringA tag ID (tag_…) or name.
expected_versionintegerThe tag's version from get_workspace_overview. If it changed since, the call fails instead of overwriting a newer change.
confirmbooleanMust be true to perform this destructive action, unless dry_run is true.
dry_runbooleanPreview the result without changing anything.

Output

FieldTypeDescription
deletedrequiredobject
posts_untaggedrequiredintegerPosts that lost this tag.
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "delete_tag", "arguments": {"tag":"<string>"} }

// Typed client
await carechannel.delete_tag({"tag":"<string>"});