Get available voices

Retrieve all available voices for assistant configuration

GET /user/assistants/voices

Get available voices

cURL

curl --request GET \
  --url https://app.voicery.ai/api/user/assistants/voices \
  --header 'Authorization: Bearer <token>'

200 Response

[
  {
    "id": 1,
    "name": "Sarah",
    "mode": "pipeline"
  },
  {
    "id": 2,
    "name": "Michael",
    "mode": "pipeline"
  },
  {
    "id": 3,
    "name": "Emma",
    "mode": "multimodal"
  },
  {
    "id": 4,
    "name": "David",
    "mode": "multimodal"
  },
  {
    "id": 5,
    "name": "Sophia",
    "mode": "pipeline"
  }
]

This endpoint returns a list of all available voices that can be used when creating or updating assistants, with optional filtering by assistant mode.

Query Parameters

mode · string

Filter voices by assistant mode. Options: pipeline, multimodal

Response fields

data · array

Show properties

id · integer

The unique identifier of the voice

name · string

The display name of the voice

mode · string

The assistant mode this voice is compatible with (pipeline or multimodal)

200 Response

[
  {
    "id": 1,
    "name": "Sarah",
    "mode": "pipeline"
  },
  {
    "id": 2,
    "name": "Michael",
    "mode": "pipeline"
  },
  {
    "id": 3,
    "name": "Emma",
    "mode": "multimodal"
  },
  {
    "id": 4,
    "name": "David",
    "mode": "multimodal"
  },
  {
    "id": 5,
    "name": "Sophia",
    "mode": "pipeline"
  }
]

Notes

• Use the id field when creating or updating assistants
• The mode field indicates which assistant engine the voice is compatible with
• Filter by mode to get only voices compatible with your intended assistant type
• If no mode filter is provided, all available voices are returned
• Only voices that are public or belong to the authenticated user are returned