List available voices
This endpoint returns the available voices from a specific provider (ElevenLabs) for use with agents.
GET
/Agent/voiceThis endpoint returns the available voices from a specific provider (ElevenLabs) for use with agents.
Authentication
Authentication required. Send your user API key in the X-API-Key header.
Parameters
| Name | Location | Type | Required | Description | Constraints |
|---|---|---|---|---|---|
provider | query | VoiceProvider | No | 0 = RetellAI; 1 = ElevenLabs | — |
Request body
This operation does not accept a request body.
Example request
curl --request GET \
--url 'https://api.zild.ai/Agent/voice?provider={provider}' \
--header 'X-API-Key: YOUR_USER_API_KEY'
Responses
| Status | Description | Response body |
|---|---|---|
200 | Successfully returned voices | application/json · array<VoiceDto> |
Example response (200):
[
{
"voiceId": "string",
"voiceName": "string",
"provider": "string",
"accent": "string",
"gender": "string",
"age": "string",
"previewAudioUrl": "string",
"category": "string",
"language": "string",
"description": "string"
}
]
Data models
VoiceDto
| Property | Type | Required | Description | Constraints |
|---|---|---|---|---|
voiceId | string | No | — | nullable |
voiceName | string | No | — | nullable |
provider | string | No | — | nullable |
accent | string | No | — | nullable |
gender | string | No | — | nullable |
age | string | No | — | nullable |
previewAudioUrl | string | No | — | nullable |
category | string | No | — | nullable |
language | string | No | — | nullable |
description | string | No | — | nullable |
VoiceProvider
0 = RetellAI; 1 = ElevenLabs
integer