Skip to main content
POST
Update Voice Settings

Overview

Updates one or more synthesis defaults on a voice you own. Equivalent to Update Voice Config, kept under both verbs and paths for backwards compatibility. New integrations should use this POST /settings form. At least one of the body fields must be provided.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
UUID of the voice.

Body Parameters

number
Default consistency for V1 and V2 voices. V1: 0-1 float (higher is more consistent). V2: 0-64 integer (lower is more consistent). Reject values outside that range.
number
Default expressiveness for V1 and V2 voices. 0-1 float.
boolean
Boost flag for V3 voices only. true adds language-consistency prompting at the cost of some flexibility for code-switching. Disable if your agent needs to speak languages outside the source sample.

Response

Echoes back the resolved settings on success. For V1 and V2 voices:
number
number
string
The engine identifier of the voice.
For V3 voices:
boolean
string
To see the rest of the voice’s fields after an update, call Get Voice.

Docs for agents: llms.txt