curl -X POST 'https://api.elevenlabs.io/v1/voices/voice-id/edit' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=string' \
  -F 'files=@sample.bin' \
  -F 'remove_background_noise=false' \
  -F 'description=string' \
  -F 'labels=[object Object]' \
  -F 'moderate_metadata=false'

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

> Edit Voice

## 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/edit' \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F 'name=string'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| voice_id | path | string | Yes | Voice ID to be used, you can use http... |
| name | body | string | Yes | The name that identifies this voice.... |
| files | body | string[] | No | Audio files to add to the voice |

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

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

POST

/v1/voices/{voice_id}/edit

ElevenLabs API

Edit Voice

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

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 210 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/edit' \  -H "xi-api-key: $ELEVENLABS_API_KEY" \  -F 'name=string' \  -F 'files=@sample.bin' \  -F 'remove_background_noise=false' \  -F 'description=string' \  -F 'labels=[object Object]' \  -F 'moderate_metadata=false'

Get a free ElevenLabs API key → sponsored

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.
name	body	string	Yes	The name that identifies this voice. This will be displayed in the dropdown of the website.
files	body	string[]	No	Audio files to add to the voice
remove_background_noise	body	boolean	No	If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse.
description	body	string	No	A description of the voice.
labels	body	object	No	Labels for the voice. Keys can be language, accent, gender, or age.
moderate_metadata	body	boolean	No	Run synchronous LLM moderation over the voice name and description when they change. Has no effect unless the voice_library_metadata_moderation feature flag is enabled for the user.

Response 200 OK

{
  "status": "ok"
}