Voice Designs
Get a voice design
Returns the latest version of a voice design, or a specific version when ?version=N is provided. The id parameter accepts either a UUID or the design name.
get/voice_designs/{id}
Path parameters
idstring required
The voice design UUID or name.
Query parameters
versioninteger
Specific version number to retrieve. Defaults to the latest version.
Response
The requested voice design.
Example response
{
"data": {
"created_at": "2024-01-01T00:00:00Z",
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "friendly-narrator",
"prompt": "Speak in a warm tone",
"provider": "Telnyx",
"provider_supported_models": [
"Qwen3TTS"
],
"provider_voice_id": "550e8400-e29b-41d4-a716-446655440000",
"record_type": "voice_design",
"text": "Hello, welcome.",
"updated_at": "2024-01-01T00:00:00Z",
"version": 1,
"version_created_at": "2024-01-01T00:00:00Z",
"voice_sample_size": 48000
}
}