Create a call
Initiate an outbound call immediately or schedule it for a future time. Requires calls:write scope.
Note: This endpoint does not support Idempotency-Key header. Retries may create duplicate calls. Use GET /calls to verify before retrying.
Rate Limit: 100 requests/minute per API key. Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Authentication: Bearer token with API key (alto_live_... or alto_test_...).
Error Format: { success: false, error: { code, message, details?, requestId } }
Authorization
api-key AuthorizationBearer <token>
API Key (alto_live_... or alto_test_...)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/api/v1/public/calls" \ -H "Content-Type: application/json" \ -d '{ "agentId": "01945a2b-3c4d-7e8f-0000-000000000000", "phoneNumber": "79001234567" }'{ "success": true, "data": { "callId": "01945a2b-3c4d-7e8f-0000-000000000000", "status": "queued", "createdAt": "2026-02-15T14:30:00.000Z" }}Empty
Empty
Empty
Empty
Empty