agents9

agents.test1

bridge_phrases5

channels3

channels.targets6

channels.twilio3

channels.twilio.numbers4

conversation-config2

conversations1

custom_messages7

dashboards6

data_sources5

directory11

events1

experiments9

incidents6

insights1

insights.folders8

insights.tools7

insights.workflows12

language_groups6

organizations4

organizations.sip_ip_ranges4

outbound.batches9

outbound.campaigns5

permissions1

prompts8

pronunciations5

roles5

services5

session_debug3

session_labels3

sessions4

sessions.full-summary1

sessions.latency1

sessions.timeline1

sessions.transcript1

takeouts3

tools6

users7

voice_groups6

agents

Get Available Agent Voices

Changed on Aug 29, 2026

Get available agent voices.

Each voice's status is resolved against the current date. Retired voices are omitted unless their display name is passed in selected_voice, so a saved config still referencing a retired voice can render it as a locked field. A voice group holds one voice per language, so the parameter is repeatable.

get/api/v1/agents/voices/available

Request

Base URL
https://api.syllable.cloud
URL
https://api.syllable.cloud/api/v1/agents/voices/available
Auth
API key in header Syllable-API-Key

Query parameters

selected_voicestring[] nullable

Response

Successful Response

provider'OpenAI' | 'ElevenLabs' | 'Google' | 'Cartesia' required

TTS provider for an agent voice.

Display names of voices that Syllable supports.

The variable name of an agent voice (used when processing messages).

gender'female' | 'male' required

Gender for an agent voice.

Model for an agent voice.

deprecatedboolean required

Whether the voice is in the deprecation warning window

sunset_datestring date nullable

Date the voice becomes retired and can no longer be saved or selected

removedboolean

Whether the voice is force-retired regardless of sunset_date

fallbackstring nullable

Voice substituted at runtime for critical features once this one is retired

status'active' | 'deprecated' | 'retired'

Effective deprecation state of a model, resolved against a reference date.

Example response

[
  {
    "supported_languages": [
      {
        "name": "English"
      }
    ]
  }
]

Changes

Aug 29, 2026547a632a6e36 Revision changes
- info
  added the new optional query request parameter selected_voice
- info
  added the non-success response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Aug 17, 2026609194a6be9c Revision changes
- warning
  added the new Cartesia enum value to the / response property for the response status
- warning
  added the new Corey (US) enum value to the / response property for the response status
- warning
  added the new Daniel (US) enum value to the / response property for the response status
- warning
  added the new Emilio (MX) enum value to the / response property for the response status
- warning
  added the new Emma (US) enum value to the / response property for the response status
- warning
  added the new Fernanda (MX) enum value to the / response property for the response status
- warning
  added the new Haeun (KR) enum value to the / response property for the response status
- warning
  added the new Hua (CN) enum value to the / response property for the response status
- warning
  added the new Jaewon (KR) enum value to the / response property for the response status
- warning
  added the new Linda (US) enum value to the / response property for the response status
- warning
  added the new Liu (CN) enum value to the / response property for the response status
- warning
  added the new Marta (ES) enum value to the / response property for the response status
- warning
  added the new Mateo (MX) enum value to the / response property for the response status
- warning
  added the new Minji (KR) enum value to the / response property for the response status
- warning
  added the new Skylar (US) enum value to the / response property for the response status
- warning
  added the new Suda (TH) enum value to the / response property for the response status
- warning
  added the new Taehyun (KR) enum value to the / response property for the response status
- warning
  added the new Xia (VN) enum value to the / response property for the response status
- warning
  added the new Ximena (MX) enum value to the / response property for the response status
- warning
  added the new cartesia:Corey enum value to the / response property for the response status
- warning
  added the new cartesia:Daniel enum value to the / response property for the response status
- warning
  added the new cartesia:Emilio enum value to the / response property for the response status
- warning
  added the new cartesia:Emma enum value to the / response property for the response status
- warning
  added the new cartesia:Fernanda enum value to the / response property for the response status
- warning
  added the new cartesia:Haeun enum value to the / response property for the response status
- warning
  added the new cartesia:Hua enum value to the / response property for the response status
- warning
  added the new cartesia:Jaewon enum value to the / response property for the response status
- warning
  added the new cartesia:Linda enum value to the / response property for the response status
- warning
  added the new cartesia:Liu enum value to the / response property for the response status
- warning
  added the new cartesia:Marta enum value to the / response property for the response status
- warning
  added the new cartesia:Mateo enum value to the / response property for the response status
- warning
  added the new cartesia:Minji enum value to the / response property for the response status
- warning
  added the new cartesia:Skylar enum value to the / response property for the response status
- warning
  added the new cartesia:Suda enum value to the / response property for the response status
- warning
  added the new cartesia:Taehyun enum value to the / response property for the response status
- warning
  added the new cartesia:Xia enum value to the / response property for the response status
- warning
  added the new cartesia:Ximena enum value to the / response property for the response status
- warning
  added the new sonic-3.5 enum value to the / response property for the response status

Operation history (5 revisions)