Skip to main content

Base URL

https://cawme.com/api/v1
A sandbox environment is available for testing:
https://sandbox.cawme.com/api/v1

Authentication

All endpoints require a Bearer token:
Authorization: Bearer <your-clerk-token>
See the Authentication guide for details.

Request format

  • All request bodies use Content-Type: application/json
  • All timestamps are ISO 8601 in UTC (e.g., 2026-03-01T10:00:00Z)
  • IDs are prefixed strings: inst_<hex> for instances, call_<hex> for calls

Response codes

CodeMeaning
200OK
201Resource created
204No content (successful delete/terminate)
400Bad request — missing or invalid fields
401Unauthorized — missing or invalid token
403Forbidden — valid token but access denied
404Resource not found
501Not yet implemented

Idempotency

If you create a call for an instance that already has an active call (QUEUED, RINGING, or IN_PROGRESS), the API returns the existing call with status 200 instead of creating a duplicate. This guards against double-submissions from network retries or React Strict Mode.

Rate limiting

Demo token requests are rate-limited per IP. Authenticated requests follow standard fair-use limits.

Resources