> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Voice Sample

> Append training samples to an existing voice clone you own.

## Overview

Appends one or more audio samples to an existing voice clone, retraining the voice on the expanded sample set.

Sample limits depend on the voice's engine. **BTTS V1** voices accept up to 5 samples total. **BTTS V2** and **BTTS V3** voices are single-sample by design and do not accept additional samples; use [Clone Voice](https://docs.bland.ai/api-v1/post/clone.md) to create a new voice instead.

Sent as `multipart/form-data`.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Form Fields

**voice\_id** `string` *required*

UUID of the voice to add samples to. Must be a voice your org owns.

**audio\_samples** `file[]` *required*

WAV files to append. Each file 1-60 seconds, max 10 MB. The combined sample count after this call cannot exceed 5 for a V1 voice.

***

## Response

**status** `string`

`success` on success.

**samples** `array`

The samples currently attached to the voice after the update. See [List Voice Samples](https://docs.bland.ai/api-v1/get/voices-id-samples.md#response) for field shape.

```json Response theme={null}
{
  "status": "success",
  "samples": [
    {
      "id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
      "voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
      "transcription": null,
      "duration_seconds": 11.4,
      "created_at": "2026-06-22T21:34:31.347Z"
    }
  ]
}
```

```json No Files theme={null}
{
  "data": null,
  "errors": [
    { "error": "BAD_REQUEST", "message": "No audio files provided" }
  ]
}
```

```json Wrong Engine theme={null}
{
  "data": null,
  "errors": [
    { "error": "INTERNAL_SERVER_ERROR", "message": "Adding samples is only supported for BTTS voices" }
  ]
}
```

```json Too Many Samples theme={null}
{
  "data": null,
  "errors": [
    { "error": "Validation Error", "message": "Cannot add 2 sample(s). Voice already has 4 samples. Maximum allowed is 5 samples per voice." }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.