Skip to main content

API Reference

The Callem Studio Public API provides programmatic access to your call data and knowledge base content. Use it to integrate Callem Studio with your CRM, data warehouse, or any external system.

Base URL

https://api.callem.ai/v1

Available Resources

ResourceEndpointsDescription
CallsGET, GET :id, DELETE :idList, retrieve, and delete call records
KnowledgeGET, GET :id, POST, DELETE :idList, retrieve, create, and delete knowledge base items

Response Format

All responses are returned as JSON. List endpoints include pagination metadata:
{
  "data": [...],
  "pagination": {
    "total": 142,
    "limit": 100,
    "offset": 0
  }
}

Error Handling

The API uses standard HTTP status codes:
CodeDescription
200Success
201Created
400Bad request — check your parameters
401Unauthorized — invalid or missing API key
403Forbidden — IP not allowed or resource access denied
404Not found — resource doesn’t exist or belongs to another project
429Rate limited — too many requests
500Internal server error
Error responses include a message:
{
  "statusCode": 401,
  "message": "Invalid API key"
}

Rate Limiting

The API is rate-limited to 120 requests per minute per IP address. If you exceed this limit, you’ll receive a 429 Too Many Requests response.

Data Scoping

Each API key is bound to a single project. All API calls are automatically scoped to that project’s data — you cannot access data from other projects.
The Public API is read-only for calls (list, get, delete) and read-write for knowledge (list, get, create, delete). Agent configuration, campaigns, and other management operations are only available through the dashboard.