Update Account Voice
Voice
Update Account Voice
Set the account-level default voice for AI phone agents.
This becomes the default voice for ALL AI agents under this account, controlling how they sound on phone calls. Individual agents or specific calls can still override this setting.
Voice resolution priority:
- Per-call voice_id (POST /v1/calls)
- Agent voice_id (PATCH /v1/agents/)
- Account default (this endpoint) ← you are here
- System default (Supportive Male)
Accepts:
- A preset name: “female-1”, “female-2”, “female-3”, “male-1”, “male-2”, “male-3”
- A Cartesia voice UUID: “f786b574-daa5-4673-aa0c-cbe3e8534c02”
PATCH
Update Account Voice
Authorizations
AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...
Body
application/json
Set account-level default voice.
TTS voice preset name (e.g. 'female-1', 'male-1') or Cartesia voice UUID
Response
Successful Response