Skip to main content
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_here
string
required
Must be set to application/json

Request 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.
  • 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