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

# Edit Voice

`POST /v1/voices/{voice_id}/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}/edit`
- Auth: none declared

Edit a voice created by you.

## 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 `multipart/form-data`

- BodyEditVoiceV1VoicesVoiceIdEditPost
  - `name` string, required: The name that identifies this voice. This will be displayed in the dropdown of the website.
  - `files` string[]: Audio files to add to the voice
  - `remove_background_noise` boolean: 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` string, nullable: A description of the voice.
  - `labels` union: Labels for the voice. Keys can be language, accent, gender, or age.
    - object
    - string
  - `moderate_metadata` boolean: 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`

Successful Response

- EditVoiceResponseModel
  - `status` string, required: The status of the voice 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-06-08** `37fac3c5a2d7`: 1 info
  - added the new optional request property `moderate_metadata`
- **2026-02-08** `5b595807512c`: 2 info
  - api operation id `Edit_voice_v1_voices__voice_id__edit_post` removed and replaced with `edit_voice`
  - request property `labels` list-of-types was widened by adding types `object` to media type `multipart/form-data`
- **2025-05-16** `503db4198a44`: 1 breaking, 5 info
  - the response's body type changed from no type to `object` for status `200`
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
  - request property `description` list-of-types was widened by adding types `null` to media type `multipart/form-data`
  - …2 more
- **2024-11-22** `dd10bbb98a6e`: 1 info
  - added the new optional request property `remove_background_noise`

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/voices/:voice_id/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)