Rate Voice
curl --request POST \
--url https://api.bland.ai/v1/voices/{id}/rate \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '{
"rating": 123
}'import requests
url = "https://api.bland.ai/v1/voices/{id}/rate"
payload = { "rating": 123 }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({rating: 123})
};
fetch('https://api.bland.ai/v1/voices/{id}/rate', 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}/rate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'rating' => 123
]),
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}/rate"
payload := strings.NewReader("{\n \"rating\": 123\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.bland.ai/v1/voices/{id}/rate")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"rating\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}/rate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rating\": 123\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"total_ratings": 8,
"average_rating": 4.875
}
Voices
Rate Voice
Give a public library voice a 1-5 star rating.
POST
/
v1
/
voices
/
{id}
/
rate
Rate Voice
curl --request POST \
--url https://api.bland.ai/v1/voices/{id}/rate \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '{
"rating": 123
}'import requests
url = "https://api.bland.ai/v1/voices/{id}/rate"
payload = { "rating": 123 }
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({rating: 123})
};
fetch('https://api.bland.ai/v1/voices/{id}/rate', 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}/rate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'rating' => 123
]),
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}/rate"
payload := strings.NewReader("{\n \"rating\": 123\n}")
req, _ := http.NewRequest("POST", 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.post("https://api.bland.ai/v1/voices/{id}/rate")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"rating\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}/rate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rating\": 123\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"total_ratings": 8,
"average_rating": 4.875
}
Overview
Records your rating (1-5) for a voice in the Bland library. Ratings are aggregated and surfaced asaverage_rating and total_ratings on each voice. Each caller can have at most one active rating per voice, sending a new rating overwrites the previous one. Send DELETE to the same path to clear your rating.
This call is throttled to 20 ratings per minute per org.
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
UUID of the voice to rate.
Body Parameters
integer
required
Rating value, 1 to 5.
Response
string
success on success.number
The voice’s new total rating count.
number
The voice’s new average rating.
{
"status": "success",
"total_ratings": 8,
"average_rating": 4.875
}
Docs for agents: llms.txt
Was this page helpful?
⌘I