---
title: "Add Samples To Pvc Voice"
method: POST
path: "/v1/voices/pvc/{voice_id}/samples"
tags: ["pvc-voices"]
---

# Add Samples To Pvc Voice

`POST /v1/voices/pvc/{voice_id}/samples`

## 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/pvc/{voice_id}/samples`
- Auth: none declared

Add audio samples to a PVC voice

## 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`

- BodyAddSamplesToPVCVoiceV1VoicesPvcVoiceIdSamplesPost
  - `files` string[], required: Audio files used to create 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.

## Response `200`

Successful Response

- SampleResponseModel[]
  - `sample_id` string, required: The ID of the sample.
  - `file_name` string, required: The name of the sample file.
  - `mime_type` string, required: The MIME type of the sample file.
  - `size_bytes` integer, required: The size of the sample file in bytes.
  - `hash` string, required: The hash of the sample file.
  - `duration_secs` number, nullable
  - `remove_background_noise` boolean, nullable
  - `has_isolated_audio` boolean, nullable
  - `has_isolated_audio_preview` boolean, nullable
  - `speaker_separation` SpeakerSeparationResponseModel
    - `voice_id` string, required: The ID of the voice.
    - `sample_id` string, required: The ID of the sample.
    - `status` 'not_started' | 'pending' | 'completed' | 'failed', required: The status of the speaker separation.
    - `speakers` object, nullable: The speakers of the sample.
    - `selected_speaker_ids` string[], nullable: The IDs of the selected speakers.
  - `trim_start` integer, nullable
  - `trim_end` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-08** `5b595807512c`: 1 info
  - api operation id `Add_samples_to_PVC_voice_v1_voices_pvc__voice_id__samples_post` removed and replaced with `add_pvc_voice_samples`
- **2025-05-16** `503db4198a44`: 1 info
  - endpoint added

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