Get Workbench Setup Version
curl --request GET \
--url https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}', 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/evals/workbench-setups/{setup_id}/versions/{version_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"errors": null,
"data": {
"id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"version_number": 3,
"name": "Onboarding Quality Check",
"description": "Evaluation suite for Q1 onboarding calls.",
"state": "archived",
"attached_agents": [
{
"eval_agent_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
"eval_agent_version_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"weight": 50,
"target_level_keys": ["good", "excellent"]
},
{
"eval_agent_id": "a0b1c2d3-e4f5-6789-abcd-ef0123456789",
"eval_agent_version_id": "b1c2d3e4-f5a6-7890-bcde-f01234567890",
"weight": 50,
"target_level_keys": ["acceptable"]
}
],
"pass_threshold_pct": 75,
"run_mode": "audio",
"default_test_config_id": null,
"default_call_ids": [
"call_abc123",
"call_def456"
],
"created_from_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-04-10T09:00:00.000Z",
"updated_at": "2026-04-15T12:00:00.000Z"
}
}
Versions
Get Workbench Setup Version
Fetch one version of a workbench setup.
GET
/
v1
/
evals
/
workbench-setups
/
{setup_id}
/
versions
/
{version_id}
Get Workbench Setup Version
curl --request GET \
--url https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}', 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/evals/workbench-setups/{setup_id}/versions/{version_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"errors": null,
"data": {
"id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"version_number": 3,
"name": "Onboarding Quality Check",
"description": "Evaluation suite for Q1 onboarding calls.",
"state": "archived",
"attached_agents": [
{
"eval_agent_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
"eval_agent_version_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"weight": 50,
"target_level_keys": ["good", "excellent"]
},
{
"eval_agent_id": "a0b1c2d3-e4f5-6789-abcd-ef0123456789",
"eval_agent_version_id": "b1c2d3e4-f5a6-7890-bcde-f01234567890",
"weight": 50,
"target_level_keys": ["acceptable"]
}
],
"pass_threshold_pct": 75,
"run_mode": "audio",
"default_test_config_id": null,
"default_call_ids": [
"call_abc123",
"call_def456"
],
"created_from_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-04-10T09:00:00.000Z",
"updated_at": "2026-04-15T12:00:00.000Z"
}
}
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The ID of the workbench setup.
string
required
The ID of the version to retrieve.
Response
object
The full version object.
Show version fields
Show version fields
string
Unique identifier for this version.
string
ID of the organization that owns this version.
string
ID of the parent workbench setup.
integer
Monotonically increasing version number.
string
Display name of this version.
string | null
Description of this version, or
null if not set.string
"editable" for a draft, "archived" for a published snapshot.array
Eval agents attached to this version. Each item contains
eval_agent_id, eval_agent_version_id, weight (0-100), and target_level_keys (array of strings).integer | null
Percentage of calls that must pass for a run to be considered passing (0-100), or
null if not set.string
How calls are evaluated. One of
text, audio, or full.string | null
ID of the default test configuration, or
null if not set.array of strings
Default call IDs to evaluate against. Up to 5000 entries.
string | null
ID of the version this was forked from, or
null if it is the first version.string | null
Identifier of the user who created this version, or
null.string
ISO 8601 timestamp for when this version was created.
string
ISO 8601 timestamp for when this version was last updated.
null
null on success.{
"errors": null,
"data": {
"id": "d4e5f6a7-b8c9-0123-defa-234567890123",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"version_number": 3,
"name": "Onboarding Quality Check",
"description": "Evaluation suite for Q1 onboarding calls.",
"state": "archived",
"attached_agents": [
{
"eval_agent_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
"eval_agent_version_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
"weight": 50,
"target_level_keys": ["good", "excellent"]
},
{
"eval_agent_id": "a0b1c2d3-e4f5-6789-abcd-ef0123456789",
"eval_agent_version_id": "b1c2d3e4-f5a6-7890-bcde-f01234567890",
"weight": 50,
"target_level_keys": ["acceptable"]
}
],
"pass_threshold_pct": 75,
"run_mode": "audio",
"default_test_config_id": null,
"default_call_ids": [
"call_abc123",
"call_def456"
],
"created_from_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-04-10T09:00:00.000Z",
"updated_at": "2026-04-15T12:00:00.000Z"
}
}
Was this page helpful?
⌘I