Get a voice

Returns a single voice from the workspace registry by ID.

GET /api/v2/voices/{voice_id}

Get a voice

cURL

curl --request GET \
  --url https://api.heymilo.ai/api/v2/voices/{voice_id} \
  --header 'X-API-KEY: <api-key>'

200

{
  "data": {
    "id": "<string>",
    "provider": "<string>",
    "provider_voice_id": "<string>",
    "name": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "object": "voice",
    "language": "en",
    "country_code": "US",
    "gender": "female",
    "preview_url": "<string>",
    "labels": {}
  },
  "meta": {}
}

Authorizations

X-API-KEY · string · header · required

API key for authentication. Pass your key in the X-API-KEY header.

Headers

X-API-KEY · string | null

Authorization · string | null

X-Workspace-Id · string | null

Path Parameters

voice_id · string · required

Response

200

application/json

Successful Response

data · VoiceResponse · object · required

A voice from the workspace voice registry.

Voices are added from external providers (ElevenLabs, Cartesia, LMNT) and stored in the workspace registry. The id (prefixed wrv-) is used in posting configs as voice_id.

Show child attributes

meta · Meta · object

Optional metadata. Shape varies by endpoint.