Skip to main content
POST
Create User Template

Headers

string
required
Your API key for authentication.

Body Parameters

string
Display name for the template. Maximum 120 characters.
string
Description of the template. Maximum 4000 characters. Pass null to leave blank.
string
Category label for the template. Maximum 64 characters. Pass null to leave blank.
string
Evaluation modality. Either text or audio.
string
System prompt for the eval agent, in Markdown. Maximum 50000 characters.
string
Evaluation prompt, in Markdown. Maximum 50000 characters.
array
Ordered scoring levels. Each level object requires level_key (string, 1-64 chars), label (string, 1-80 chars), and prompt_md (string). The color field is optional: one of rose, amber, gold, emerald, blue, indigo, violet, or fog.
array
Array of level_key strings that represent the passing threshold.
string
Access scope for the template. One of private, org, or public.
string
UUID of an existing eval agent to snapshot content from.
string
UUID of a specific version of the eval agent to snapshot. Only used when from_agent_id is provided. Defaults to the agent’s current version if omitted.
There are two creation paths. Pass from_agent_id (optionally with from_version_id) to snapshot an existing agent’s content into the template, or pass inline content fields to build one from scratch. When both are supplied, from_agent_id provides the content and inline fields act as overrides.

Response

string
Unique identifier (UUID) for the new 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.

Docs for agents: llms.txt