Docs: Tool reference
admin toolset

delete_category

Delete a category. Deletes a category. Posts in it stay on their board without a category. Name it by ID, or by name or slug plus board if several boards share the name. 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}/categories/{category}
Behavior
changes datadestructive (confirm: true, dry_run)

Input

FieldTypeDescription
categoryrequiredstringThe category's ID (cat_…), name or slug.
boardstringThe category's board, when the name is ambiguous.
expected_versionintegerThe category's version from your last read. 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_updatedrequiredintegerPosts that lost this category.
admin_urlrequiredstring (uri)

Calling it

// MCP: tools/call
{ "name": "delete_category", "arguments": {"category":"<string>"} }

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