curl -X POST 'https://api.elevenlabs.io/v1/voices/voice-id/settings/edit' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "similarity_boost": 1,
  "speed": 1,
  "stability": 1,
  "style": 0,
  "use_speaker_boost": true
}'

# POST /v1/voices/{voice_id}/settings/edit (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20

> Edit Voice Settings

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X POST 'https://api.elevenlabs.io/v1/voices/voice-id/settings/edit' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"similarity_boost":1,"speed":1,"stability":1,"style":0,"use_speaker_boost":true}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| voice_id | path | string | Yes | Voice ID to be used, you can use http... |
| stability | body | number | No | Determines how stable the voice is an... |
| use_speaker_boost | body | boolean | No | This setting boosts the similarity to... |
Other params: similarity_boost, style, speed

## Response (200 OK)
{"status":"ok"}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

POST

POST /v1/voices/{voice_id}/settings/edit — ElevenLabs API

ElevenLabs API

Edit Voice Settings

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 223 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X POST 'https://api.elevenlabs.io/v1/voices/voice-id/settings/edit' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "similarity_boost": 1,  "speed": 1,  "stability": 1,  "style": 0,  "use_speaker_boost": true}'

Parameters

Name	In	Type	Required	Description
voice_id	path	string	Yes	Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.
stability	body	number	No	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	body	boolean	No	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	body	number	No	Determines how closely the AI should adhere to the original voice when attempting to replicate it.
style	body	number	No	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	body	number	No	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.

Response 200 OK

{
  "status": "ok"
}

Get a free ElevenLabs API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.