Add a voice
Add a voice to this agency’s library so its agents can speak with it. Find the id with POST /voices/search. The voice is copied into every library the agency’s agents are served from and still counts once against the allowance. Returns the whole library, so no follow-up read is needed.
A voice already on the account (another agency added it, or this agency added and later removed it) is not added again: the request answers 409 VOICE_ALREADY_SHARED, spends nothing, and references.voiceId names the voice to select instead. It is already in GET /voices with source: "shared".
Required API key scope: voices:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Body
Response
Voice added. The full library is returned.
Voices currently added.
x >= 01
How many voices this account may add. Null means unlimited.
x >= 05
Voices still addable. Null whenever limit is null: an unlimited allowance has no remainder, and reporting a number here would be inventing one.
x >= 04
