ChatterBeamDevelopers
POST · mentions:write

Create category

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

WriteMinimum role: editor

REST

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

MCP

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

Input

This route has no path parameters. Check OpenAPI for operation-specific query or JSON body fields.

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