---
title: "List Custom Voices"
api: "GET /v1/api/voices/custom"
description: "Retrieve all custom voices created in your workspace."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

## Headers
<ParamField header="x-workspace-id" type="string" required>
Workspace identifier for the API.
</ParamField>

## Response

A plain array of the custom voices created in this workspace with [Create Custom Voice](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/voices/create). Empty if there are none.

<ResponseField name="id" type="string">
The voice ID. Use it as `ttsModel.voiceId` with provider `cartesia`, and to delete the voice.
</ResponseField>

<ResponseField name="name" type="string">
Name of the custom voice.
</ResponseField>

<ResponseField name="provider" type="string">
Always `cartesia`.
</ResponseField>

<ResponseField name="description" type="string">
Description of the custom voice. Empty string if none was given.
</ResponseField>

<ResponseField name="language" type="string">
Language code for the voice.
</ResponseField>

<ResponseField name="created_at" type="string">
Timestamp when the voice was created.
</ResponseField>

## Errors

| Status | Body | When |
| --- | --- | --- |
| `400` | `{"error": "Workspace ID is required"}` | No `x-workspace-id` |
| `500` | `{"error": "..."}` | The voice catalog couldn't be read |

<ResponseExample>
```json
[
  {
    "id": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee",
    "name": "Custom Sales Voice",
    "provider": "cartesia",
    "description": "Friendly sales representative voice",
    "language": "en",
    "created_at": "2026-10-29T09:00:00.000Z"
  }
]
```
</ResponseExample>


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
