> ## Documentation Index
> Fetch the complete documentation index at: https://graph.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# workbench__update_metadata

> Updates the plan draft's top-level fields.

## Fields

* `identifier`, `name`, `description`, `exemplars`, `input_schema`, `requires_servers`.
* `finish` sets the result: a `solver`, an `output` map, or neither for a silent plan.

## Notes

* Changing `identifier` makes it a new plan.

| Available to | Effect |
| - | - |
| Workbench agents only | Not marked read-only |

## Input

**description** `string`

What the plan does — shown in the catalog and used for routing.

**exemplars** `string[]`

Example requests the plan should handle; replaces the current list.

**finish** `object | string`

Set the plan's finish: "silent", EITHER \{output: \{a map of key -> template string}} for a structured result, OR \{solver: \{queryToAnswer: string, systemPrompt?: string}} for LLM synthesis.

**finish.output** `object`

Map of output key to template string, e.g. \{"summary": "\{\{E3.text}}"}.

**finish.solver** `object`

**finish.solver.queryToAnswer** `string`

**finish.solver.systemPrompt** `string`

**identifier** `string`

Tool-name-safe identifier (letters, digits, \_, -). Changing it detaches the draft from its loaded file.

**input\_schema** `object`

Replace the plan's input schema (a JSON Schema object describing the plan's inputs, e.g. \{"type":"object","required":\["pr"],"properties":\{"pr":\{"type":"integer"}}}). Pass null to clear it.

**name** `string`

Human-readable display name.

**output\_schema** `object`

Replace the JSON Schema of an output plan's result; its properties are the `finish.output` keys. Pass null to clear it.

**requires\_servers** `string[]`

Replace the list of MCP server names the plan requires to be configured (gates catalog visibility). Empty array clears it.

## Output

**identifier** `string`

**name** `string`

**ok** `boolean`

```json Output theme={null}
{
  "identifier": "sprint_report",
  "name": "Sprint report",
  "ok": true
}
```


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