# Auto

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

> The `hanzo auto` commands.

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

Workflows that run themselves, on a schedule or a webhook.

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

```bash
hanzo auto 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.

### Flows

| Command                                 | What it does                                                                 |
| --------------------------------------- | ---------------------------------------------------------------------------- |
| `hanzo auto flows create`               | Creates an automation and its initial DRAFT version in one call.             |
| `hanzo auto flows disable <id>`         | Disarms a flow's trigger and marks it DISABLED.                              |
| `hanzo auto flows enable <id>`          | Arms a flow's trigger and marks it ENABLED.                                  |
| `hanzo auto flows get <id>`             | Returns one automation and its latest version.                               |
| `hanzo auto flows list`                 | Returns the caller org's automations, most-recently-updated first.           |
| `hanzo auto flows operations <id>`      | Edit a flow — rename it, retarget its trigger, or add, move and delete steps |
| `hanzo auto flows rm <id>`              | Deletes one automation, its versions and its run history.                    |
| `hanzo auto flows run <id>`             | Starts one durable run of a flow now.                                        |
| `hanzo auto flows update <id>`          | Updates one automation's metadata in place.                                  |
| `hanzo auto flows versions create <id>` | Adds a new DRAFT version to a flow.                                          |
| `hanzo auto flows versions get <id>`    | Returns one flow's versions, newest first.                                   |

### Hooks

| Command                                        | What it does                                                  |
| ---------------------------------------------- | ------------------------------------------------------------- |
| `hanzo auto hooks source add <source> <event>` | Fire an event that starts every enabled flow subscribed to it |

### Provider

| Command                        | What it does                                                     |
| ------------------------------ | ---------------------------------------------------------------- |
| `hanzo auto provider list`     | Returns the connector catalogue.                                 |
| `hanzo auto provider run <id>` | Executes one provider action in-process and answers the outcome. |

### Runs

| Command                       | What it does                                                         |
| ----------------------------- | -------------------------------------------------------------------- |
| `hanzo auto runs get <id>`    | Returns one run.                                                     |
| `hanzo auto runs list`        | Returns the caller org's run history, newest first.                  |
| `hanzo auto runs resume <id>` | Release a run waiting at an approval step, with the approval payload |