Skip to main content
DELETE
/
v1
/
voices
/
{id}
/
samples
Delete Voice Samples
curl --request DELETE \
  --url https://api.bland.ai/v1/voices/{id}/samples \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "sample_ids": [
    "<string>"
  ]
}
'
{
  "status": "success",
  "samples": []
}

Overview

Removes the specified samples from a voice clone. The voice is retrained against the remaining samples. If you remove every sample from a voice it becomes unusable for synthesis; delete the voice itself via Delete Voice if that is your intent.

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

id
string
required
UUID of the parent voice.

Body Parameters

sample_ids
string[]
required
Array of sample UUIDs to delete.
{ "sample_ids": ["d15b199a-1b79-4664-9a9a-b149ee3b136a"] }

Response

status
string
success on success.
samples
array
The samples remaining on the voice after the deletion.
{
  "status": "success",
  "samples": []
}

Docs for agents: llms.txt