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

> Puts a whole plan, agent or tool file in the pane as the current draft.

## Behavior

* Checks the draft right away and returns any problems. Nothing is written to disk.
* For a plan, omit `yaml` to use the plan `plan__compose_plan` last returned.
* Replacing a plan draft with unsaved changes fails unless `overwrite_draft` is true.

| Available to | Effect |
| - | - |
| Workbench agents only | Read-only |

## Input

**kind** `enum\<string\>` *required*

What the file is

Available options: `plan`, `agent`, `tool`

**overwrite\_draft** `boolean`

Plans only: discard unsaved changes to the current plan draft, only after the user confirms

**yaml** `string`

The whole file. Required for an agent or tool; omit it for a plan to publish what plan\_\_compose\_plan returned

## Output

**identifier** `string`

**steps** `integer`

**validation** `string`

```json Output theme={null}
{
  "identifier": "sprint_report",
  "steps": 3,
  "validation": "ok"
}
```


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