ChatterBeamDevelopers
DELETE · mentions:write

Delete category

Execute the delete_category capability through REST or MCP with the same authorization and project checks.

DestructiveMinimum role: editor

REST

DELETE/api/v1/categories/:categoryId
curl "https://chatterbeam.com/api/v1/categories/{categoryId}" \
  --request DELETE \
  --header "Authorization: Bearer $CHATTERBEAM_API_KEY" \
  --header "Idempotency-Key: unique-operation-key"

MCP

Tool name: delete_category. The tool returns the same structured { data, meta } result as REST.

Input

categoryIdRequired path identifier

Authorization

Required scope: mentions:write. Scope checks are followed by current project membership and the editor minimum role.

Related resources

REST conventions·MCP setup·Errors and limits