---
title: "Edit Voice Settings"
method: POST
path: "/v1/voices/{voice_id}/settings/edit"
tags: ["voices"]
---

# Edit Voice Settings

`POST /v1/voices/{voice_id}/settings/edit`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/voices/{voice_id}/settings/edit`
- Auth: none declared

Edit your settings for a specific voice. "similarity_boost" corresponds to "Clarity + Similarity Enhancement" in the web app and "stability" corresponds to "Stability" slider in the web app.

## Path parameters

- `voice_id` string, required: Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- VoiceSettingsResponseModel
  - `stability` number, nullable: Determines how stable the voice is and the randomness between each generation. Lower values introduce broader emotional range for the voice. Higher values can result in a monotonous voice with limited emotion.
  - `use_speaker_boost` boolean, nullable: This setting boosts the similarity to the original speaker. Using this setting requires a slightly higher computational load, which in turn increases latency.
  - `similarity_boost` number, nullable: Determines how closely the AI should adhere to the original voice when attempting to replicate it.
  - `style` number, nullable: Determines the style exaggeration of the voice. This setting attempts to amplify the style of the original speaker. It does consume additional computational resources and might increase latency if set to anything other than 0.
  - `speed` number, nullable: Adjusts the speed of the voice. A value of 1.0 is the default speed, while values less than 1.0 slow down the speech, and values greater than 1.0 speed it up.
  - `clone_strength` number, nullable: Controls how closely the voice matches the professional voice clone samples, from 0 (low) to 1 (high). We recommend 0 for most use cases. Increase this value only if you experience issues with the default settings. Only applies to professional voice clones fine-tuned for the selected v4 model.

## Response `200`

Successful Response

- EditVoiceSettingsResponseModel
  - `status` string, required: The status of the voice settings edit request. If the request was successful, the status will be 'ok'. Otherwise an error message with status 500 will be returned.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `5ae19a7323a5`: 1 info
  - added the new optional request property `clone_strength`
- **2026-02-08** `5b595807512c`: 4 warning, 6 info
  - the `similarity_boost/anyOf[subschema #1]/` request property's max was set to `1.00`
  - the `stability/anyOf[subschema #1]/` request property's max was set to `1.00`
  - the `similarity_boost/anyOf[subschema #1]/` request property's min was set to `0.00`
  - the `stability/anyOf[subschema #1]/` request property's min was set to `0.00`
  - …6 more
- **2025-05-16** `503db4198a44`: 2 breaking, 1 warning, 8 info
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/VoiceSettingsResponseModel` from the request body `allOf` list
  - added the new optional request property `similarity_boost`
  - …7 more
- **2023-11-25** `659035dd9081`: 1 info
  - the `style` request property default value changed from `0.5` to `0`
- **2023-07-17** `8437c7ca225f`: 1 info
  - the `use_speaker_boost` request property default value changed from `false` to `true`

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/voices/:voice_id/settings/edit/post.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)