Skip to main content
POST
/
v1
/
voices
/
library
/
add
/
{id}
Add Library Voice
curl --request POST \
  --url https://api.bland.ai/v1/voices/library/add/{id} \
  --header 'authorization: <authorization>'
{
  "status": "success",
  "message": "Voice is in your library",
  "voice": {
    "id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
    "name": "StephenD_v1 (published)",
    "description": null,
    "public": false,
    "ratings": 0,
    "tags": ["Beige Clone V2", "male"],
    "user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
    "voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
    "service": "BTTS_V2",
    "finetuned": false,
    "consistency": null,
    "expressiveness": null,
    "voice_meta": null,
    "is_creator_voice": false
  }
}

​
Overview

Adds a voice from the public Bland voice library to your org’s voice list. Once added, the voice can be used like any other voice you own: passed to Speak, configured via Update Voice Config, renamed, and so on. The original library voice is unchanged. The endpoint returns a new voice record that lives in your org and points at the same underlying model. This call is throttled to 30 add operations per minute per org.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the shared voice to add.

​
Response

​
status
string
success on success.
​
message
string
Human-readable confirmation.
​
voice
object
The newly added voice in your org. See Get Voice for the field list. The id is unique to your org, the voice_id field points at the underlying model.
{
  "status": "success",
  "message": "Voice is in your library",
  "voice": {
    "id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
    "name": "StephenD_v1 (published)",
    "description": null,
    "public": false,
    "ratings": 0,
    "tags": ["Beige Clone V2", "male"],
    "user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
    "voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
    "service": "BTTS_V2",
    "finetuned": false,
    "consistency": null,
    "expressiveness": null,
    "voice_meta": null,
    "is_creator_voice": false
  }
}
Docs for agents: llms.txt