Docs: Tool reference
admin toolset

delete_status

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

FieldTypeDescription
statusrequiredstringA status ID (sts_…) or name, e.g. "Planned".
reassign_torequiredstringThe status its posts move to.
expected_versionintegerThe status'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
reassigned_torequiredobject
posts_movedrequiredinteger
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "delete_status", "arguments": {"status":"<string>","reassign_to":"<string>"} }

// Typed client
await carechannel.delete_status({"status":"<string>","reassign_to":"<string>"});