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
Field
Type
Description
tagrequired
string
A tag ID (tag_…) or name.
expected_version
integer
The tag's version from get_workspace_overview. If it changed since, the call fails instead of overwriting a newer change.
confirm
boolean
Must be true to perform this destructive action, unless dry_run is true.