Voices
Get Voice Details
Fetch one voice catalog entry by ID.
GET
Get Voice Details
Read only
Get voice details for a voice visible to the authenticated workspace. API-key responses contain
id, name, gender, provider, and accent; they do not include a preview URL or model configuration.
When To Get Voice Details
- Voice picker UIs: render the selected voice with its name and provider badge when editing an agent.
- Agent configuration validation: confirm the saved voice still exists and supports the language the agent is set to before publishing changes.
- Migration tooling: when a provider deprecates a voice, look up replacements by language and gender.
Path parameters
Errors
404 Not Foundis returned when the voice does not exist, is unavailable, or is not visible to this workspace.401 Unauthorizedis returned when the API key is missing or revoked.
Related endpoints
- List Voices: search and filter all available voices.
- List Accents: see available accent options across voices.
- Text-to-speech and voices: guidance on choosing a voice.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Voice ID
Example:
"voice_mfgt2k9x4q7w1z"