# Replace a saved voice's audio

- **Method:** `POST`
- **Path:** `/api/v1/voices/{voice_id}/audio`
- **Operation ID:** `update_voice_audio_api_v1_voices__voice_id__audio_post`
- **Tags:** Voices

Replace a saved voice's audio and its transcript together. Without `text` the transcript is cleared and the next generation transcribes the new audio.

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Path parameters

- **`voice_id` (required)**: `string`

## Request body

**Required:** `true`

**Content type:** `application/json`

schema: `UpdateVoiceAudioRequest`

- **`audio_base64` (required)**: `string`

  Base64-encoded replacement audio (WAV)
- **`text`**: `string | null`

  Transcript of the new audio. Omit it to clear the transcript. The next generation then transcribes the new audio.
- **`transcript_manual`**: `boolean | null`

  True if the user wrote or corrected text
- **`word_timestamps`**: `(array of object) | null`

  Word-level timestamps for text

**Example:**

```json
{
  "audio_base64": "UklGRi4AAABXQVZFZm10IBAAAA...",
  "text": "Hello, this is a sample of my voice.",
  "word_timestamps": [
    {
      "additionalProperty": "anything"
    }
  ],
  "transcript_manual": true
}
```

## Responses

### 200 Successful Response

**Content type:** `application/json`

schema: `SuccessMessageResponse`

- **`success` (required)**: `boolean`

  Whether the operation succeeded
- **`message`**: `string`, default: `""`

  Human-readable result message

**Example:**

```json
{
  "success": true,
  "message": ""
}
```

### 400 Invalid voice ID format.

### 404 Voice not found.

### 422 Validation Error

**Content type:** `application/json`

schema: `HTTPValidationError`

- **`detail`**: `array`

  **Items:**

  schema: `ValidationError`
  - **`loc` (required)**: `array of (string | integer)`
  - **`msg` (required)**: `string`
  - **`type` (required)**: `string`
  - **`ctx`**: `object`
  - **`input`**: `any`

**Example:**

```json
{
  "detail": [
    {
      "loc": [
        ""
      ],
      "msg": "",
      "type": "",
      "input": null,
      "ctx": {}
    }
  ]
}
```

## Schemas

- `HTTPValidationError` — shown above.
- `SuccessMessageResponse` — shown above.
- `UpdateVoiceAudioRequest` — shown above.
- `ValidationError` — shown above.