ChatterBeamDevelopers
POST · alerts:write

Create alert

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

WriteMinimum role: editorExternal action

REST

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

MCP

Tool name: create_alert. 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: alerts:write. Scope checks are followed by current project membership and the editor minimum role.

Related resources

REST conventions·MCP setup·Errors and limits