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>"
]
}
'import requests
url = "https://api.bland.ai/v1/voices/{id}/samples"
payload = { "sample_ids": ["<string>"] }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({sample_ids: ['<string>']})
};
fetch('https://api.bland.ai/v1/voices/{id}/samples', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/voices/{id}/samples",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'sample_ids' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices/{id}/samples"
payload := strings.NewReader("{\n \"sample_ids\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.bland.ai/v1/voices/{id}/samples")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"sample_ids\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}/samples")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sample_ids\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"samples": []
}
{
"data": null,
"errors": [
{ "error": "INVALID_REQUEST", "message": "Missing or invalid sample_ids array" }
]
}
Samples
Delete Voice Samples
Remove one or more training samples from a voice clone you own.
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>"
]
}
'import requests
url = "https://api.bland.ai/v1/voices/{id}/samples"
payload = { "sample_ids": ["<string>"] }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({sample_ids: ['<string>']})
};
fetch('https://api.bland.ai/v1/voices/{id}/samples', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/voices/{id}/samples",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'sample_ids' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices/{id}/samples"
payload := strings.NewReader("{\n \"sample_ids\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.bland.ai/v1/voices/{id}/samples")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"sample_ids\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}/samples")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sample_ids\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"samples": []
}
{
"data": null,
"errors": [
{ "error": "INVALID_REQUEST", "message": "Missing or invalid sample_ids array" }
]
}
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
Your API key for authentication.
Path Parameters
UUID of the parent voice.
Body Parameters
Array of sample UUIDs to delete.
{ "sample_ids": ["d15b199a-1b79-4664-9a9a-b149ee3b136a"] }
Response
success on success.The samples remaining on the voice after the deletion.
{
"status": "success",
"samples": []
}
{
"data": null,
"errors": [
{ "error": "INVALID_REQUEST", "message": "Missing or invalid sample_ids array" }
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I