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

# tai state-templates

> Manage platform state-template documents.

Manage platform state-template documents.

```console theme={null}
$ tai state-templates [OPTIONS] COMMAND [ARGS]...
```

## `tai state-templates delete`

Delete a state-template document (refused while it is attached).

```console theme={null}
$ tai state-templates delete [OPTIONS] {name}
```

| Argument | Description                     |
| -------- | ------------------------------- |
| `name`   | The template name. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai state-templates get`

Show one state-template document.

```console theme={null}
$ tai state-templates get [OPTIONS] {name}
```

| Argument | Description                     |
| -------- | ------------------------------- |
| `name`   | The template name. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai state-templates list`

List every platform state-template document.

```console theme={null}
$ tai state-templates list [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai state-templates put`

Create or replace a state-template document.

```console theme={null}
$ tai state-templates put [OPTIONS] {name}
```

| Argument | Description                     |
| -------- | ------------------------------- |
| `name`   | The template name. *(required)* |

| Option                  | Description                                                       |
| ----------------------- | ----------------------------------------------------------------- |
| `--data` `<str>`  | The template document JSON.                                       |
| `--file` `<path>` | A file holding the template document JSON.                        |
| `--replace`             | Overwrite an existing template of this name. *(default: `False`)* |
| `--json` / `--no-json`  | Emit raw JSON instead of human tables.                            |