Agents
Update Agent Voice
Update an agent’s voice settings and configuration
PUT
Update Agent Voice
Update an agent’s voice configuration including voice template, language, conversation speed, and other voice-related settings.Endpoint
Path parameters
string
required
The unique identifier of the voice agent to update.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
string
required
Voice template ID. Use List Voice Templates to retrieve available IDs.
number
required
Conversation playback speed multiplier. Range: greater than
1, less than 2.string
required
Who speaks first. Options:
agent, user.string
Ambient background sound for the conversation (e.g.,
office, cafe, quiet). Optional.number
Volume of the ambient background sound. Range:
0 (muted) to 2 (loud). Default: 1.string
Agent language code (e.g.,
en-US, pt-BR). Optional — only sent when changing the agent’s spoken language. The voice template must support the chosen language.number
Voice similarity boost. Range:
0.5 to 1.0. Required only for high-fidelity voice templates (the quality_tier of the voice template determines whether this field is accepted). Higher values reinforce voice characteristics.number
Voice stability. Range:
0.5 to 1.0. Required only for high-fidelity voice templates. Higher values produce more consistent output; lower values produce more expressive output.Example requests
Response
Success Response (200 OK)
Response fields
boolean
required
Indicates if the operation was successful.
string
required
Success message confirming the agent voice was updated.
object
required
The updated agent object with new voice settings.
Error responses
Validation Error (422)
404 Not Found
401 Unauthorized
403 Forbidden
Error codes
Important notes
Agent status will be set to draft. After updating the agent’s voice, the agent will be automatically set to “draft” status and will need to be published again to become active.
Voice settings affect call quality. Higher stability values (closer to 1.0) provide more consistent voice output, while higher similarity values (closer to 1.0) enhance voice characteristics.
Related endpoints
- Get Agent:
GET /api/v1/agents/{agent_id} - Update Agent Knowledge:
PUT /api/v1/agents/{agent_id}/knowledge - Update Agent Calling Settings:
PUT /api/v1/agents/{agent_id}/calling - Publish Agent:
POST /api/v1/agents/{agent_id}/publish - List Agents:
GET /api/v1/agents