> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Voices

> Browse all available AI voices and select one for your voice agent or a single call.

## Overview

Sendora provides a managed voice catalog. The Voices API lists the voices available to your workspace, including English, Spanish, French, German, and more.

Use voice IDs when:

* Creating or updating a **voice agent** (`POST /public/voice-agents`)
* Placing a one-off call with a **per-call voice override** (`POST /public/voice/calls`)
* Populating a **voice picker UI** in a GHL workflow action config

## List all voices

```bash theme={"dark"}
curl https://api.sendora.ai/api/v1/public/voices \
  -H "X-API-Key: sk_live_..."
```

```json theme={"dark"}
{
  "voices": [
    {
      "voice_id": "Tanya-English-Australian",
      "name": "Tanya",
      "description": "An Australian English female voice, warm and professional.",
      "preview_url": "https://api.sendora.ai/media/voice-preview/example",
      "language": "en-AU",
      "gender": "female"
    },
    {
      "voice_id": "Mark-English-US",
      "name": "Mark",
      "description": "A US English male voice, clear and confident.",
      "preview_url": "https://api.sendora.ai/media/voice-preview/example",
      "language": "en-US",
      "gender": "male"
    }
  ],
  "total": 242
}
```

## Use a voice in a voice agent

```bash theme={"dark"}
curl -X PATCH "https://api.sendora.ai/api/v1/public/voice-agents/AGENT_ID" \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "voice_id": "Tanya-English-Australian" }'
```

## Use a voice for a single call

Pass `voice_id` to `POST /public/voice/calls` to override the agent's default for that specific call only:

```bash theme={"dark"}
curl -X POST https://api.sendora.ai/api/v1/public/voice/calls \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "LEAD_ID",
    "agent_id": "AGENT_ID",
    "voice_id": "Tanya-English-Australian"
  }'
```

## Supported languages

Voices are available in 20+ languages including English (US, UK, AU, CA), Spanish (ES, MX), French, German, Portuguese (BR, PT), Italian, Dutch, Polish, Japanese, Korean, and more. Filter by `language` in the response to find the right voice for your market.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.