> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Voice Config

> Update default synthesis settings on a voice you own.

## Overview

Updates the default consistency and expressiveness settings on a voice clone. These defaults are applied when [Speak](https://docs.bland.ai/api-v2/post/tts.md) is called without per-request overrides.

Equivalent to [Update Voice Settings](https://docs.bland.ai/api-v1/post/voices-id-settings.md) (`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](https://docs.bland.ai/api-v1/get/voices-id.md#response) for the full field list.

```json Response theme={null}
{
  "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](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.