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
Path Parameters
Body Parameters
Response
{
"status": "success",
"total_ratings": 8,
"average_rating": 4.875
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
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
}