List Custom Voices
Retrieve all custom voices created in your workspace.
GET
Headers
x-workspace-idstringrequiredWorkspace identifier for the API.
Response
A plain array of the custom voices created in this workspace with Create Custom Voice. Empty if there are none.
idstringThe voice ID. Use it as ttsModel.voiceId with provider cartesia, and to delete the voice.
namestringName of the custom voice.
providerstringAlways cartesia.
descriptionstringDescription of the custom voice. Empty string if none was given.
languagestringLanguage code for the voice.
created_atstringTimestamp when the voice was created.
Errors
| Status | Body | When |
|---|---|---|
400 | {"error": "Workspace ID is required"} | No x-workspace-id |
500 | {"error": "..."} | The voice catalog couldn't be read |
[
{
"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"
}
]Last updated on