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
The unique identifier of the voice agent to update.
Request headers
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereMust be set to
application/jsonRequest body
Voice template ID. Use List Voice Templates to retrieve available IDs.
Conversation playback speed multiplier. Range: greater than
1, less than 2.Who speaks first. Options:
agent, user.Ambient background sound for the conversation (e.g.,
office, cafe, quiet). Optional.Volume of the ambient background sound. Range:
0 (muted) to 2 (loud). Default: 1.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.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.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
Indicates if the operation was successful.
Success message confirming the agent voice was updated.
The updated agent object with new voice settings.
Error responses
Validation Error (422)
404 Not Found
401 Unauthorized
403 Forbidden
Error codes
| Code | Description | HTTP Status |
|---|---|---|
AGENT_NOT_FOUND | Specified agent does not exist | 404 |
INVALID_TOKEN | Authentication token is invalid or missing | 401 |
UNAUTHORIZED | User does not have permission to update this agent | 403 |
VOICE_NOT_FOUND | Specified voice template does not exist | 404 |
VALIDATION_ERROR | Request data validation failed | 422 |
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