Delete a status. Deletes a status. Posts with it move to reassign_to (required), without emailing voters. If it was the default for new posts, reassign_to becomes the default. The last status can't be deleted. Destructive: pass confirm: true, or dry_run: true to preview. Managers and owners.
Toolset
admin
Who can call it
OwnersManagersAPI keys
REST
DELETE /api/v1/w/{workspace}/statuses/{status}
Behavior
changes datadestructive (confirm: true, dry_run)
Input
Field
Type
Description
statusrequired
string
A status ID (sts_…) or name, e.g. "Planned".
reassign_torequired
string
The status its posts move to.
expected_version
integer
The status'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.