Voices

Overview

Voices define how your AI persona sounds during a session. Each voice has a provider (ElevenLabs, Cartesia, or Azure) and a provider-specific voice ID. Assign a voice to a persona when creating or updating it.

List All Voices

Retrieve all available voices.

curl -X GET https://api.waterr.ai/v1/voices/all \
  -H "Authorization: Bearer wai_<your_key>"

[
  {
    "id": "v1-uuid-...",
    "name": "Sarah - Professional",
    "provider": "elevenlabs",
    "partner_voice_id": "abc123...",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  },
  {
    "id": "v2-uuid-...",
    "name": "James - Friendly",
    "provider": "cartesia",
    "partner_voice_id": "xyz789...",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
]

Response fields

Field	Description
`id`	Voice UUID — use this when assigning a voice to a persona or meeting
`name`	Human-readable voice name
`provider`	Voice provider: `elevenlabs`, `cartesia`, or `azure`
`partner_voice_id`	The provider’s internal voice ID

Get Voice by ID

string

required

The voice UUID

curl -X GET https://api.waterr.ai/v1/voices/{id} \
  -H "Authorization: Bearer wai_<your_key>"

Using Voices with Personas

Assign a voice when creating a persona:

curl -X POST https://api.waterr.ai/v1/personas \
  -H "Authorization: Bearer wai_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sarah Chen",
    "job_title": "VP of Engineering",
    "demeanor": "analytical",
    "voice_id": "v1-uuid-..."
  }'

Or override the voice for a specific meeting:

curl -X POST https://api.waterr.ai/v1/meetings \
  -H "Authorization: Bearer wai_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "person_name": "John Doe",
    "scenario_id": "...",
    "voice_id": "v2-uuid-..."
  }'

If you don’t specify a voice_id when creating a persona, a default voice is assigned based on the persona’s gender field.

Voice Providers

Provider	Strengths
ElevenLabs	Most natural sounding, widest voice selection
Cartesia	Lowest latency, good for fast-paced conversations
Azure Speech	Enterprise-grade, consistent quality

Voice availability depends on your plan. Contact support if you need a custom voice clone or a voice not listed in the API.

Getting Started

Meetings

Personas

Scenarios

Embed Scenario

Post-Meeting Data

Goals

Avatars

Tools

Users

Guides

Integrations

Agent Skills

Voices

Overview

List All Voices

Response fields

Get Voice by ID

Using Voices with Personas

Voice Providers

​Overview

​List All Voices

​Response fields

​Get Voice by ID

​Using Voices with Personas

​Voice Providers

Overview

List All Voices

Response fields

Get Voice by ID

Using Voices with Personas

Voice Providers