Skip to main content
PATCH
/
v1
/
voices
/
{id}
/
config
Update Voice Config
curl --request PATCH \
  --url https://api.bland.ai/v1/voices/{id}/config \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "consistency": 123,
  "expressiveness": 123,
  "boost": 123
}
'
{
  "status": "success",
  "message": "Voice configuration updated successfully",
  "voice": {
    "id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
    "name": "DocTestRename",
    "description": null,
    "public": false,
    "ratings": 0,
    "tags": ["Beige Clone V2", "male"],
    "user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
    "voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
    "service": "BTTS_V2",
    "finetuned": false,
    "consistency": 8,
    "expressiveness": null,
    "voice_meta": { "per_decode": 8 },
    "is_creator_voice": false
  }
}

​
Overview

Updates the default consistency and expressiveness settings on a voice clone. These defaults are applied when Speak is called without per-request overrides. Equivalent to Update Voice Settings (POST /v1/voices/{id}/settings). Both share the same write path; POST /settings is the canonical form and returns a lighter response envelope. This PATCH /config route is kept for backwards compatibility. The accepted parameters depend on the voice’s engine:
  • BTTS V1 voices accept consistency (0.0-1.0 float) and expressiveness (0.0-1.0 float).
  • BTTS V2 / V3 voices accept consistency (1-32 integer, lower is more consistent) and boost (0 or 1).
Only voices owned by your org can be configured.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the voice to configure.

​
Body Parameters

​
consistency
number
Default consistency for this voice. Float 0.0-1.0 for V1 voices; integer 1-32 for V2/V3 voices (lower is more consistent).
​
expressiveness
number
Default expressiveness for V1 voices only. Float 0.0-1.0.
​
boost
integer
Expressiveness boost for V2 and V3 voices only. 0 or 1.

​
Response

Returns the full updated voice.
​
status
string
success on success.
​
message
string
Human-readable confirmation, for example "Voice configuration updated successfully".
​
voice
object
The updated voice. See Get Voice for the full field list.
{
  "status": "success",
  "message": "Voice configuration updated successfully",
  "voice": {
    "id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
    "name": "DocTestRename",
    "description": null,
    "public": false,
    "ratings": 0,
    "tags": ["Beige Clone V2", "male"],
    "user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
    "voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
    "service": "BTTS_V2",
    "finetuned": false,
    "consistency": 8,
    "expressiveness": null,
    "voice_meta": { "per_decode": 8 },
    "is_creator_voice": false
  }
}
Docs for agents: llms.txt