# Studio

URL: https://docs.hanzo.ai/docs/cli/studio

> The `hanzo studio` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/studio) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/studio) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Hanzo Studio's workflow backend: every creation — an image, a poster, a document, a deck, a type system, a 3D model, an ad, a film, a voice, a song — is a run of a graph of steps that the person who started it owns.

[API reference →](https://docs.hanzo.ai/docs/openapi/studio)

```bash
hanzo studio runs list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                 | What it does                                                                                                               |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `hanzo studio chat`     | One chat turn that plans and launches runs, streamed                                                                       |
| `hanzo studio estimate` | Prices a run without starting it: the estimate POST /v1/studio/runs would reserve, step by step.                           |
| `hanzo studio gpus`     | Lists the GPUs your org has linked with `hanzo link` that can take a studio.render step, each with whether it is free now. |

### Brands

| Command                           | What it does                                                                                                                |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `hanzo studio brands create`      | Saves a brand: its tokens in the W3C design-token format (color, font, type, space, radius groups) and up to 16 logo items. |
| `hanzo studio brands get <id>`    | Reads one brand you may read.                                                                                               |
| `hanzo studio brands list`        | Lists the brands you may read — palettes and type systems as design tokens.                                                 |
| `hanzo studio brands rm <id>`     | Deletes one of your brands.                                                                                                 |
| `hanzo studio brands update <id>` | Changes one of your brands; absent fields stay as they are.                                                                 |

### Documents

| Command                              | What it does                                                                   |
| ------------------------------------ | ------------------------------------------------------------------------------ |
| `hanzo studio documents create`      | Writes a document (kind doc, its IR blocks) or a deck (kind deck, its slides). |
| `hanzo studio documents get <id>`    | Reads one document you may read.                                               |
| `hanzo studio documents list`        | Lists the documents and decks you may read, most recently changed first.       |
| `hanzo studio documents rm <id>`     | Deletes one of your documents.                                                 |
| `hanzo studio documents update <id>` | Changes one of your documents; absent fields stay as they are.                 |

### Flows

| Command                          | What it does                                               |
| -------------------------------- | ---------------------------------------------------------- |
| `hanzo studio flows create`      | Saves a graph as a flow of yours.                          |
| `hanzo studio flows get <id>`    | Reads one flow you may read.                               |
| `hanzo studio flows list`        | Lists the flows you may read, most recently changed first. |
| `hanzo studio flows rm <id>`     | Deletes one of your flows.                                 |
| `hanzo studio flows update <id>` | Changes one of your flows; absent fields stay as they are. |

### Runs

| Command                           | What it does                                                                                                                                                                                      |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo studio runs cancel <id>`   | Cancels one of your runs: a step in flight is told to stop, nothing new starts, and the reservation settles to what finished steps cost.                                                          |
| `hanzo studio runs create`        | Starts a run: name exactly one of template, flow or graph, with the input its inputs schema asks for.                                                                                             |
| `hanzo studio runs events <id>`   | Stream a run's progress as Server-Sent Events                                                                                                                                                     |
| `hanzo studio runs get <id>`      | Reads one run: its graph, its input, every step's state, the assets it made and what it cost.                                                                                                     |
| `hanzo studio runs list`          | Lists the runs you may read — your own and those your org shares — newest first.                                                                                                                  |
| `hanzo studio runs retry <id>`    | Resumes one of your runs that failed or was cancelled: the steps that did not succeed run again in the same run, and the steps that did keep their outputs and are neither run nor charged again. |
| `hanzo studio runs update <id>`   | Renames or shares one of your runs.                                                                                                                                                               |
| `hanzo studio runs versions <id>` | Lists every version of a creation you may read — the runs in this run's lineage — oldest (version 1) first.                                                                                       |

### Templates

| Command                              | What it does                                                                                  |
| ------------------------------------ | --------------------------------------------------------------------------------------------- |
| `hanzo studio templates create`      | Saves a template to your org: a graph and the inputs schema its runs are started with.        |
| `hanzo studio templates get <id>`    | Reads one template: a catalog slug or one of your org's templates you may read.               |
| `hanzo studio templates list`        | Lists templates: the public catalog (org empty) first, then your org's own that you may read. |
| `hanzo studio templates rm <id>`     | Deletes one of your templates.                                                                |
| `hanzo studio templates update <id>` | Changes one of your templates; absent fields stay as they are.                                |

### Threads

| Command                         | What it does                                              |
| ------------------------------- | --------------------------------------------------------- |
| `hanzo studio threads get <id>` | Reads one of your threads and its messages, oldest first. |
| `hanzo studio threads list`     | Lists your chat threads, most recent first.               |
| `hanzo studio threads rm <id>`  | Deletes one of your threads.                              |
