The Retone AI API allows you to programmatically manage voice agents, phone numbers, calls, and more. Use the API to integrate Retone AI into your existing systems and workflows.
Base URL
All API requests are made to:
https://api.retone.ai/api/v1
Authentication
All API endpoints require authentication using a Bearer token. Include your API key in the Authorization header:
curl -X GET "https://api.retone.ai/api/v1/agents" \
-H "Authorization: Bearer YOUR_API_KEY"
Keep your API key secure. Do not expose it in client-side code or public repositories.
API Key Management
You can generate and manage API keys from your dashboard settings.
Rate Limits
The API is rate-limited to ensure fair usage:
| Plan | Rate Limit |
|---|
| Free | 60 requests/minute |
| Pro | 300 requests/minute |
| Enterprise | Custom limits |
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1640000000
{
"success": true,
"data": {
// Response data
}
}
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "Description of the error"
}
}
Common HTTP Status Codes
| Code | Description |
|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Resource doesn’t exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error |
Available Endpoints
