curl --request GET \
--url https://app.thinnest.ai/api/v1/byok/voices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/byok/voices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/byok/voices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"provider": {
"id": "elevenlabs",
"label": "ElevenLabs"
},
"model": "eleven_flash_v2_5",
"complete": true,
"items": [
{
"id": "EXAVITQu4vr4xnSDxMaL",
"name": "Sarah",
"language": "en",
"gender": "female",
"sample": "https://storage.googleapis.com/eleven-public-prod/premade/voices/EXAVITQu4vr4xnSDxMaL/sample.mp3",
"own": false
},
{
"id": "Xb7hH8MSUJpSbSDYk0k2",
"name": "Alice",
"language": "en",
"gender": "female",
"sample": null,
"own": true
}
]
}List BYOK Voices
The voices your own voice provider offers your key — what Set Agent BYOK Voice accepts. sample is a clip the provider hosts, free to play, when it has one. On Cartesia the list starts with your own cloned voices, then the whole library (up to 2,000 voices); if Cartesia is slow to answer the list can come back short: complete is then false, it is not cached, and you should ask again. A per-call overrides.voice is checked the same way as an agent’s voice: if it is not on the list we ask the provider about that one voice directly, so a voice missing from a short list is still accepted. Refused with 409 when the workspace is not using its own keys; its voices are then List Voices. These are the voices of the agents that use your keys: an agent set to byok: "off" (Update Agent) speaks in our voices from List Voices, at our normal pricing, while your other agents stay on your keys.
curl --request GET \
--url https://app.thinnest.ai/api/v1/byok/voices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/byok/voices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/byok/voices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"provider": {
"id": "elevenlabs",
"label": "ElevenLabs"
},
"model": "eleven_flash_v2_5",
"complete": true,
"items": [
{
"id": "EXAVITQu4vr4xnSDxMaL",
"name": "Sarah",
"language": "en",
"gender": "female",
"sample": "https://storage.googleapis.com/eleven-public-prod/premade/voices/EXAVITQu4vr4xnSDxMaL/sample.mp3",
"own": false
},
{
"id": "Xb7hH8MSUJpSbSDYk0k2",
"name": "Alice",
"language": "en",
"gender": "female",
"sample": null,
"own": true
}
]
}Authorizations
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace. Refused with 404 (Workspace not found.) when the id is unknown, is not one of your customers, or is not an org_… id; 410 when that customer was deleted (restore it with POST /customers/{id}/restore until it is erased); 403 when the key belongs to one customer workspace (it cannot act as another); 400 when your workspace is not a developer workspace. /customers/* and GET /customers/usage are your own workspace's and refuse the header with 400: call them without it.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Response
Your provider's voices.