Create a voice evaluation golden set
curl --request POST \
--url https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Support Q&A Golden Set",
"cases": [
{
"audio_url": "https://cdn.example.com/test-audio-1.wav",
"expected_outcome": "Agent resolved billing question correctly"
}
],
"description": "Reference test cases for support agent quality"
}
'import requests
url = "https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets"
payload = {
"name": "Support Q&A Golden Set",
"cases": [
{
"audio_url": "https://cdn.example.com/test-audio-1.wav",
"expected_outcome": "Agent resolved billing question correctly"
}
],
"description": "Reference test cases for support agent quality"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Support Q&A Golden Set',
cases: [
{
audio_url: 'https://cdn.example.com/test-audio-1.wav',
expected_outcome: 'Agent resolved billing question correctly'
}
],
description: 'Reference test cases for support agent quality'
})
};
fetch('https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets', 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.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets",
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([
'name' => 'Support Q&A Golden Set',
'cases' => [
[
'audio_url' => 'https://cdn.example.com/test-audio-1.wav',
'expected_outcome' => 'Agent resolved billing question correctly'
]
],
'description' => 'Reference test cases for support agent quality'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets"
payload := strings.NewReader("{\n \"name\": \"Support Q&A Golden Set\",\n \"cases\": [\n {\n \"audio_url\": \"https://cdn.example.com/test-audio-1.wav\",\n \"expected_outcome\": \"Agent resolved billing question correctly\"\n }\n ],\n \"description\": \"Reference test cases for support agent quality\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Support Q&A Golden Set\",\n \"cases\": [\n {\n \"audio_url\": \"https://cdn.example.com/test-audio-1.wav\",\n \"expected_outcome\": \"Agent resolved billing question correctly\"\n }\n ],\n \"description\": \"Reference test cases for support agent quality\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Support Q&A Golden Set\",\n \"cases\": [\n {\n \"audio_url\": \"https://cdn.example.com/test-audio-1.wav\",\n \"expected_outcome\": \"Agent resolved billing question correctly\"\n }\n ],\n \"description\": \"Reference test cases for support agent quality\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "vevg_golden_set_001",
"name": "<string>",
"case_count": 123
}
}API Reference
Create a voice evaluation golden set
Create a golden set (reference test suite) for voice agent evaluation. Contains test cases with audio URLs and expected outcomes. Use golden sets to establish baseline evaluation criteria and track agent quality over time.
POST
/
api
/
v1
/
agents
/
voice-eval
/
golden-sets
Create a voice evaluation golden set
curl --request POST \
--url https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Support Q&A Golden Set",
"cases": [
{
"audio_url": "https://cdn.example.com/test-audio-1.wav",
"expected_outcome": "Agent resolved billing question correctly"
}
],
"description": "Reference test cases for support agent quality"
}
'import requests
url = "https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets"
payload = {
"name": "Support Q&A Golden Set",
"cases": [
{
"audio_url": "https://cdn.example.com/test-audio-1.wav",
"expected_outcome": "Agent resolved billing question correctly"
}
],
"description": "Reference test cases for support agent quality"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Support Q&A Golden Set',
cases: [
{
audio_url: 'https://cdn.example.com/test-audio-1.wav',
expected_outcome: 'Agent resolved billing question correctly'
}
],
description: 'Reference test cases for support agent quality'
})
};
fetch('https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets', 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.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets",
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([
'name' => 'Support Q&A Golden Set',
'cases' => [
[
'audio_url' => 'https://cdn.example.com/test-audio-1.wav',
'expected_outcome' => 'Agent resolved billing question correctly'
]
],
'description' => 'Reference test cases for support agent quality'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets"
payload := strings.NewReader("{\n \"name\": \"Support Q&A Golden Set\",\n \"cases\": [\n {\n \"audio_url\": \"https://cdn.example.com/test-audio-1.wav\",\n \"expected_outcome\": \"Agent resolved billing question correctly\"\n }\n ],\n \"description\": \"Reference test cases for support agent quality\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Support Q&A Golden Set\",\n \"cases\": [\n {\n \"audio_url\": \"https://cdn.example.com/test-audio-1.wav\",\n \"expected_outcome\": \"Agent resolved billing question correctly\"\n }\n ],\n \"description\": \"Reference test cases for support agent quality\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.orbit.devotel.io/api/v1/agents/voice-eval/golden-sets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Support Q&A Golden Set\",\n \"cases\": [\n {\n \"audio_url\": \"https://cdn.example.com/test-audio-1.wav\",\n \"expected_outcome\": \"Agent resolved billing question correctly\"\n }\n ],\n \"description\": \"Reference test cases for support agent quality\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "vevg_golden_set_001",
"name": "<string>",
"case_count": 123
}
}Authorizations
BearerApiKey
Dashboard JWT token from Clerk
Body
application/json
Response
201 - application/json
Golden set created successfully
Show child attributes
Show child attributes
⌘I