Get User Template
curl --request GET \
--url https://api.bland.ai/v1/evals/user-templates/{id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/user-templates/{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/user-templates/{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/user-templates/{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/user-templates/{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/user-templates/{id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/user-templates/{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{
"data": {
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"key": "my_hallucination_check",
"name": "My Hallucination Check",
"description": "Customized hallucination detection for our product domain.",
"category": "quality",
"modality": "text",
"system_prompt_md": "You are an expert evaluator assessing whether an AI agent fabricated information.",
"prompt_md": "Review the conversation and identify any claims that were factually incorrect or unsupported.",
"levels": [
{
"level_key": "no_hallucination",
"label": "No Hallucination",
"prompt_md": "The agent made no factually incorrect or unsupported claims.",
"color": "emerald"
},
{
"level_key": "hallucination_detected",
"label": "Hallucination Detected",
"prompt_md": "The agent stated something factually incorrect or unsupported.",
"color": "rose"
}
],
"target_level_keys": ["no_hallucination"],
"visibility": "org",
"source_agent_id": null,
"source_version_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-27T10:00:00.000Z",
"updated_at": "2026-05-27T10:00:00.000Z"
},
"errors": null
}
Templates
Get User Template
Fetch one of your organization’s saved eval agent templates.
GET
/
v1
/
evals
/
user-templates
/
{id}
Get User Template
curl --request GET \
--url https://api.bland.ai/v1/evals/user-templates/{id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/user-templates/{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/user-templates/{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/user-templates/{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/user-templates/{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/user-templates/{id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/user-templates/{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{
"data": {
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"key": "my_hallucination_check",
"name": "My Hallucination Check",
"description": "Customized hallucination detection for our product domain.",
"category": "quality",
"modality": "text",
"system_prompt_md": "You are an expert evaluator assessing whether an AI agent fabricated information.",
"prompt_md": "Review the conversation and identify any claims that were factually incorrect or unsupported.",
"levels": [
{
"level_key": "no_hallucination",
"label": "No Hallucination",
"prompt_md": "The agent made no factually incorrect or unsupported claims.",
"color": "emerald"
},
{
"level_key": "hallucination_detected",
"label": "Hallucination Detected",
"prompt_md": "The agent stated something factually incorrect or unsupported.",
"color": "rose"
}
],
"target_level_keys": ["no_hallucination"],
"visibility": "org",
"source_agent_id": null,
"source_version_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-27T10:00:00.000Z",
"updated_at": "2026-05-27T10:00:00.000Z"
},
"errors": null
}
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The UUID of the user template to retrieve.
Response
string
Unique identifier (UUID) for the template.
string
UUID of the organization that owns this template.
string
Short key used to reference the template.
string
Display name of the template.
string
Description of the template, or
null.string
Category of the template, or
null.string
Evaluation modality. Either
text or audio.string
System prompt for the eval agent, in Markdown.
string
Evaluation prompt, in Markdown.
array
Ordered scoring levels.
array
Array of
level_key strings that represent the passing threshold.string
Access scope. One of
private, org, or public.string
UUID of the eval agent this template was snapshotted from, or
null.string
UUID of the specific version snapshotted, or
null.string
UUID of the user who created the template, or
null.string
ISO 8601 timestamp of when the template was created.
string
ISO 8601 timestamp of when the template was last updated.
{
"data": {
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"key": "my_hallucination_check",
"name": "My Hallucination Check",
"description": "Customized hallucination detection for our product domain.",
"category": "quality",
"modality": "text",
"system_prompt_md": "You are an expert evaluator assessing whether an AI agent fabricated information.",
"prompt_md": "Review the conversation and identify any claims that were factually incorrect or unsupported.",
"levels": [
{
"level_key": "no_hallucination",
"label": "No Hallucination",
"prompt_md": "The agent made no factually incorrect or unsupported claims.",
"color": "emerald"
},
{
"level_key": "hallucination_detected",
"label": "Hallucination Detected",
"prompt_md": "The agent stated something factually incorrect or unsupported.",
"color": "rose"
}
],
"target_level_keys": ["no_hallucination"],
"visibility": "org",
"source_agent_id": null,
"source_version_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-27T10:00:00.000Z",
"updated_at": "2026-05-27T10:00:00.000Z"
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I