> ## 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.

# Update User Template

> Update a saved eval agent template. The source pointers cannot be changed.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**id** `string` *required*

The UUID of the user template to update.

### Body Parameters

**name** `string`

Display name for the template. Maximum 120 characters.

**description** `string`

Description of the template. Maximum 4000 characters. Pass `null` to clear.

**category** `string`

Category label for the template. Maximum 64 characters. Pass `null` to clear.

**system\_prompt\_md** `string`

System prompt for the eval agent, in Markdown. Maximum 50000 characters.

**prompt\_md** `string`

Evaluation prompt, in Markdown. Maximum 50000 characters.

**levels** `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`.

**target\_level\_keys** `array`

Array of `level_key` strings that represent the passing threshold.

**visibility** `string`

Access scope for the template. One of `private`, `org`, or `public`.

### 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.

**level object**

**level\_key** `string`

Short identifier for the level, 1-64 characters.

**label** `string`

Display label for the level, 1-80 characters.

**prompt\_md** `string`

Prompt describing this level's criteria, in Markdown.

**color** `string`

Optional display color. One of `rose`, `amber`, `gold`, `emerald`, `blue`, `indigo`, `violet`, or `fog`.

**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.

```json Response theme={null}
{
  "data": {
    "id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
    "org_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
    "key": "my_hallucination_check",
    "name": "My Hallucination Check (Updated)",
    "description": "Updated description 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": "minor_hallucination",
        "label": "Minor Hallucination",
        "prompt_md": "The agent made one or more small inaccuracies that did not materially mislead the user.",
        "color": "amber"
      },
      {
        "level_key": "major_hallucination",
        "label": "Major Hallucination",
        "prompt_md": "The agent stated clearly false or fabricated information.",
        "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-27T15:45:00.000Z"
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.