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
Available Resources
| Resource | Endpoints | Description |
|---|
| Calls | GET, GET :id, DELETE :id | List, retrieve, and delete call records |
| Knowledge | GET, GET :id, POST, DELETE :id | List, retrieve, create, and delete knowledge base items |
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:
| Code | Description |
|---|
200 | Success |
201 | Created |
400 | Bad request — check your parameters |
401 | Unauthorized — invalid or missing API key |
403 | Forbidden — IP not allowed or resource access denied |
404 | Not found — resource doesn’t exist or belongs to another project |
429 | Rate limited — too many requests |
500 | Internal 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.