Skip to navigation
HeyReach APIVoice

GetElevenLabsVoices

View as Markdown

The workspace’s imported ElevenLabs library, ordered by name. Reads what the last import, the daily library sync or RefreshElevenLabsLibrary stored; ElevenLabs is not called. The daily sync runs while a sender in the workspace uses an ElevenLabs voice. Assign a voice with SetSenderVoice by its voiceId (as customVoiceId) or its elevenLabsVoiceId.

A voice with an availableUntil date is leaving ElevenLabs: its owner removed it from the ElevenLabs Voice Library, and ElevenLabs stops serving it on that date. It works, and can still be assigned, until then; move its senders to another voice before that date.

Errors

  • 400 PAGING_OUT_OF_RANGE: offset is negative or limit is outside 1–500.
  • 403 NO_ACTIVE_SUBSCRIPTION, VOICE_NOTES_NOT_ENABLED or ELEVENLABS_NOT_ENABLED.

Headers

X-API-KEYstringOptional

API key header using this scheme. Example: “X-API-KEY: {API_KEY}”

Query parameters

searchstringOptional

Case-insensitive match on the voice name.

offsetintegerOptional

How many voices to skip. 0 or more; defaults to 0.

limitintegerOptional

How many voices to return, 1 to 500; defaults to 100.

Response

OK
isConnectedboolean
libraryTruncatedboolean
totalCountinteger
voiceslist of objects
connectionStatusenum or nullOptional
Null while not connected.
lastSyncedAtdatetime or nullOptional

Errors

400
Get Eleven Labs Voices Voice Request Bad Request Error
403
Get Eleven Labs Voices Voice Request Forbidden Error