Skip to main content
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>'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
The UUID of the user template to retrieve.

​
Response

​
id
string
Unique identifier (UUID) for the template.
​
org_id
string
UUID of the organization that owns this template.
​
key
string
Short key used to reference the template.
​
name
string
Display name of the template.
​
description
string
Description of the template, or null.
​
category
string
Category of the template, or null.
​
modality
string
Evaluation modality. Either text or audio.
​
system_prompt_md
string
System prompt for the eval agent, in Markdown.
​
prompt_md
string
Evaluation prompt, in Markdown.
​
levels
array
Ordered scoring levels.
​
target_level_keys
array
Array of level_key strings that represent the passing threshold.
​
visibility
string
Access scope. One of private, org, or public.
​
source_agent_id
string
UUID of the eval agent this template was snapshotted from, or null.
​
source_version_id
string
UUID of the specific version snapshotted, or null.
​
created_by
string
UUID of the user who created the template, or null.
​
created_at
string
ISO 8601 timestamp of when the template was created.
​
updated_at
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