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

# simforge drafts

> Reference for simforge drafts: usage, arguments and flags, generated from the CLI.

Generated from the CLI's own help (CLI 0.2.0-rc.5). Global flags and exit codes are on the [command reference](/cli).

## drafts freeze

Freeze the draft as an immutable revision (revisionId, revisionContentDigest) for simulate/render

```sh theme={null}
simforge drafts freeze [OPTIONS] --expected-version <N> --expected-digest <SHA256> <DRAFT_ID>
```

| Argument / flag | Notes | What |
| - | - | - |
| `<draft_id>` | required | The draft's document id (from its receipt) |
| `--expected-version N` | required | The draftVersion of the receipt this change is based on |
| `--expected-digest SHA256` | required | The contentDigest of the receipt this change is based on |
| `--name NAME` | | The revision's name |

## drafts save

Save the draft through the workspace store at an explicit version and digest

```sh theme={null}
simforge drafts save [OPTIONS] --expected-version <N> --expected-digest <SHA256> <DRAFT_ID>
```

| Argument / flag | Notes | What |
| - | - | - |
| `<draft_id>` | required | The draft's document id (from its receipt) |
| `--expected-version N` | required | The draftVersion of the receipt this change is based on |
| `--expected-digest SHA256` | required | The contentDigest of the receipt this change is based on |

## drafts show

The draft's current receipt and content: version, digest, map/actor/recording pins

```sh theme={null}
simforge drafts show [OPTIONS] <DRAFT_ID>
```

| Argument / flag | Notes | What |
| - | - | - |
| `<draft_id>` | required | The draft's document id (from its receipt) |


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