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

# Manage Voices

> List, update, and delete your custom voices

Manage your custom voice clones using the Gradium SDK.

## List All Custom Voices

Retrieve all custom voices for your organization.

```python theme={null}
import json
import gradium

client = gradium.client.GradiumClient()

all_custom_voices = await gradium.voices.get(client)
print(json.dumps(all_custom_voices, indent=2))
```

## Get a Specific Voice

Retrieve details for a single voice by its UID.

```python theme={null}
import json
import gradium

client = gradium.client.GradiumClient()

voice = await gradium.voices.get(client, voice_uid="abc123def456")
print(json.dumps(voice, indent=2))
```

## Update a Voice

Update the metadata of an existing voice. The `PUT /voices/{uid}` endpoint
accepts `name`, `description`, `language`, `start_s`, `tags`, and `rank`. The
SDK helper exposes a subset; for `language`, `tags`, or `rank` call the REST
endpoint directly.

```python theme={null}
import gradium

client = gradium.client.GradiumClient()

await gradium.voices.update(
    client,
    voice_uid="abc123def456",
    name="Updated Voice Name",
    description="Updated description",
    start_s=1.5
)
```

## Delete a Voice

Permanently delete a custom voice.

```python theme={null}
import gradium

client = gradium.client.GradiumClient()

await gradium.voices.delete(client, voice_uid="abc123def456")
```