# AI

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

> The `hanzo 3d` commands.

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

Hanzo AI — the model API on /v1 (/v1/chat/completions, /v1/messages, /v1/models and the rest of hanzoai/ai's surface) — mounted into a cloud binary with the money, ingest and telemetry callbacks cloud BUILDS but cannot INSTALL.

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

```bash
hanzo models 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 3d content <id>`       | Implements GET /v1/3d/:id/content (Download 3D splat/glb content).                                                               |
| `hanzo 3d generations`        | Implements POST /v1/3d/generations (Text/Image to 3D & Gaussian Splats).                                                         |
| `hanzo 3d get <id>`           | Implements GET /v1/3d/:id (Retrieve 3D status).                                                                                  |
| `hanzo ai account`            | Account                                                                                                                          |
| `hanzo ai activities`         | List activities                                                                                                                  |
| `hanzo ai answer`             | Answer                                                                                                                           |
| `hanzo ai feedback`           | Attaches a per-request outcome reward to the routing decision that served request\_id — the enso training loop's quality signal. |
| `hanzo ai k8s-status`         | K8s Status                                                                                                                       |
| `hanzo ai prometheus`         | Prometheus                                                                                                                       |
| `hanzo ai signin`             | Signin                                                                                                                           |
| `hanzo ai signout`            | Signout                                                                                                                          |
| `hanzo ai system`             | System                                                                                                                           |
| `hanzo ai version`            | Version                                                                                                                          |
| `hanzo audio foley`           | Serves the generative audio verbs — /v1/audio/voice (TTS), /music, /foley — that the Zen family serves natively.                 |
| `hanzo audio music`           | Serves the generative audio verbs — /v1/audio/voice (TTS), /music, /foley — that the Zen family serves natively.                 |
| `hanzo audio speech`          | The OpenAI-compatible TTS endpoint (POST /v1/audio/speech).                                                                      |
| `hanzo audio transcriptions`  | The OpenAI-compatible STT endpoint (POST /v1/audio/transcriptions, multipart: file + model \[+ language + response\_format]).    |
| `hanzo audio voice`           | Serves the generative audio verbs — /v1/audio/voice (TTS), /music, /foley — that the Zen family serves natively.                 |
| `hanzo chat completions`      | Implements the OpenAI-compatible chat completions API                                                                            |
| `hanzo chat create`           | Implements the OpenAI-compatible chat completions API                                                                            |
| `hanzo chat public`           | Serves one completion to a caller with no account.                                                                               |
| `hanzo completions create`    | Implements the OpenAI-compatible chat completions API                                                                            |
| `hanzo embeddings create`     | Implements POST /v1/embeddings (OpenAI-compatible).                                                                              |
| `hanzo images generations`    | Implements POST /v1/images/generations (OpenAI-compatible).                                                                      |
| `hanzo messages count_tokens` | Implements POST /v1/messages/count\_tokens.                                                                                      |
| `hanzo messages create`       | Implements the Anthropic Messages API.                                                                                           |
| `hanzo models list`           | Returns the list of available models from the routing table.                                                                     |
| `hanzo models providers`      | Public, secret-free list of the providers serving the models that GET /v1/models lists — the same source, projected.             |
| `hanzo rerank create`         | Implements POST /v1/rerank (Cohere/Jina-compatible).                                                                             |
| `hanzo responses create`      | Implements POST /v1/responses.                                                                                                   |
| `hanzo videos content <id>`   | Implements GET /v1/videos/{id}/content — download the finished MP4.                                                              |
| `hanzo videos generations`    | Implements POST /v1/videos/generations — the ASYNC create.                                                                       |
| `hanzo videos get <id>`       | Implements GET /v1/videos/{id} — poll a job's status.                                                                            |

### Access

| Command                              | What it does                                                                                                      |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `hanzo models access create <model>` | Records the caller's waitlist request for a gated model and answers their new standing.                           |
| `hanzo models access get <model>`    | Returns the caller's own standing for a gated model: "granted", "requested", or empty when they have never asked. |

### Articles

| Command                                         | What it does                 |
| ----------------------------------------------- | ---------------------------- |
| `hanzo ai articles create`                      | Create a article             |
| `hanzo ai articles global`                      | List articles across tenants |
| `hanzo ai articles list`                        | List articles                |
| `hanzo ai articles owner get <owner> <name>`    | Retrieve a article           |
| `hanzo ai articles owner rm <owner> <name>`     | Delete a article             |
| `hanzo ai articles owner set <owner> <name>`    | Replace a article            |
| `hanzo ai articles owner update <owner> <name>` | Update a article             |

### Assets

| Command                                       | What it does     |
| --------------------------------------------- | ---------------- |
| `hanzo ai assets create`                      | Create a asset   |
| `hanzo ai assets list`                        | List assets      |
| `hanzo ai assets owner get <owner> <name>`    | Retrieve a asset |
| `hanzo ai assets owner rm <owner> <name>`     | Delete a asset   |
| `hanzo ai assets owner scan <owner> <name>`   | Scan (asset)     |
| `hanzo ai assets owner set <owner> <name>`    | Replace a asset  |
| `hanzo ai assets owner update <owner> <name>` | Update a asset   |
| `hanzo ai assets scan`                        | Scan (asset)     |

### Chats

| Command                                      | What it does              |
| -------------------------------------------- | ------------------------- |
| `hanzo ai chats create`                      | Create a chat             |
| `hanzo ai chats global`                      | List chats across tenants |
| `hanzo ai chats list`                        | List chats                |
| `hanzo ai chats owner get <owner> <name>`    | Retrieve a chat           |
| `hanzo ai chats owner rm <owner> <name>`     | Delete a chat             |
| `hanzo ai chats owner set <owner> <name>`    | Replace a chat            |
| `hanzo ai chats owner update <owner> <name>` | Update a chat             |

### Connections

| Command                                     | What it does                                                                                                                                                                                                                                                 |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo ai connections add <provider>`       | Disconnects a third-party AI account: it deactivates the org's row so completion resolution falls back to the global Hanzo account (no BYO), and best-effort tombstones the sealed secret.                                                                   |
| `hanzo ai connections authorize <provider>` | Begins an OAuth connection for the caller's org: it binds the org into a signed state and sends the caller to the provider's authorize URL.                                                                                                                  |
| `hanzo ai connections callback <provider>`  | Completes OAuth: the org is recovered from the SIGNED state (not a header), the code is exchanged for a token, the token is SEALED into KMS (never the row/logs) through the same path as a BYOK key, and the org's provider row is upserted to "connected". |
| `hanzo ai connections create`               | Connects (or reconnects) a third-party AI account for the org by sealing the supplied key into KMS and upserting the org's provider row.                                                                                                                     |
| `hanzo ai connections list`                 | Lists the org's connectable AI accounts and whether each is currently connected.                                                                                                                                                                             |
| `hanzo ai connections rm <provider>`        | Disconnects a third-party AI account: it deactivates the org's row so completion resolution falls back to the global Hanzo account (no BYO), and best-effort tombstones the sealed secret.                                                                   |
| `hanzo ai connections usage <provider>`     | Imports the caller org's usage for a connected third-party account.                                                                                                                                                                                          |

### Dashboards

| Command                      | What it does      |
| ---------------------------- | ----------------- |
| `hanzo ai dashboards agents` | Dashboards Agents |
| `hanzo ai dashboards vm`     | Dashboards Vm     |

### Deployments

| Command                                              | What it does           |
| ---------------------------------------------------- | ---------------------- |
| `hanzo ai deployments create`                        | Create a application   |
| `hanzo ai deployments list`                          | List deployments       |
| `hanzo ai deployments owner deploy <owner> <name>`   | Deploy (application)   |
| `hanzo ai deployments owner get <owner> <name>`      | Retrieve a application |
| `hanzo ai deployments owner rm <owner> <name>`       | Delete a application   |
| `hanzo ai deployments owner set <owner> <name>`      | Replace a application  |
| `hanzo ai deployments owner undeploy <owner> <name>` | Undeploy (application) |
| `hanzo ai deployments owner update <owner> <name>`   | Update a application   |

### Files

| Command                                       | What it does              |
| --------------------------------------------- | ------------------------- |
| `hanzo ai files activate`                     | Activate (file)           |
| `hanzo ai files active`                       | Active (file)             |
| `hanzo ai files create`                       | Create a file             |
| `hanzo ai files global`                       | List files across tenants |
| `hanzo ai files list`                         | List files                |
| `hanzo ai files owner get <owner> <name>`     | Retrieve a file           |
| `hanzo ai files owner rm <owner> <name>`      | Delete a file             |
| `hanzo ai files owner set <owner> <name>`     | Replace a file            |
| `hanzo ai files owner update <owner> <name>`  | Update a file             |
| `hanzo ai files owner vectors <owner> <name>` | Vectors (file)            |
| `hanzo ai files upload`                       | Upload (file)             |

### Finetune

| Command                         | What it does                                                                                                                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai finetune cancel`      | Deletes the TrainJob CR, meters the GPU-hours used so far, and marks the job cancelled.                                                                                                                                   |
| `hanzo ai finetune deploy`      | Serves a completed job's checkpoints and registers the result as a routable model on api.hanzo.ai.                                                                                                                        |
| `hanzo ai finetune hf datasets` | Proxies a HuggingFace dataset search (dataset picker).                                                                                                                                                                    |
| `hanzo ai finetune hf models`   | Proxies a HuggingFace model search (base-model picker).                                                                                                                                                                   |
| `hanzo ai finetune hf repo`     | Returns a repo's detail (files, gated/private state).                                                                                                                                                                     |
| `hanzo ai finetune job`         | Returns one job with refreshed live status.                                                                                                                                                                               |
| `hanzo ai finetune jobs create` | Validates the request, resolves efficient defaults, persists the job, and submits a real TrainJob CR.                                                                                                                     |
| `hanzo ai finetune jobs get`    | Returns the org's jobs, refreshing live status for active ones.                                                                                                                                                           |
| `hanzo ai finetune presets`     | Returns the new-job catalog plus, when a selection is passed (?baseModel\&method\&task\&preset\[\&datasetExamples]), the recommended config so the console can render "Recommended" as a one-click, ready-to-run default. |

### Forms

| Command                                      | What it does              |
| -------------------------------------------- | ------------------------- |
| `hanzo ai forms create`                      | Create a form             |
| `hanzo ai forms data`                        | Data (form)               |
| `hanzo ai forms global`                      | List forms across tenants |
| `hanzo ai forms list`                        | List forms                |
| `hanzo ai forms owner get <owner> <name>`    | Retrieve a form           |
| `hanzo ai forms owner rm <owner> <name>`     | Delete a form             |
| `hanzo ai forms owner set <owner> <name>`    | Replace a form            |
| `hanzo ai forms owner update <owner> <name>` | Update a form             |

### Graphs

| Command                                       | What it does               |
| --------------------------------------------- | -------------------------- |
| `hanzo ai graphs create`                      | Create a graph             |
| `hanzo ai graphs global`                      | List graphs across tenants |
| `hanzo ai graphs list`                        | List graphs                |
| `hanzo ai graphs owner get <owner> <name>`    | Retrieve a graph           |
| `hanzo ai graphs owner rm <owner> <name>`     | Delete a graph             |
| `hanzo ai graphs owner set <owner> <name>`    | Replace a graph            |
| `hanzo ai graphs owner update <owner> <name>` | Update a graph             |

### MCP

| Command              | What it does                                                                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai mcp tools` | Reports what THIS PROCESS's MCP server carries: how many tools its own registry projects, optionally their names, and which subsystems this process composed. |

### Memory

| Command                    | What it does                                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai memory delete`   | Delete one of the authenticated user's memories                                                                           |
| `hanzo ai memory facts`    | List the authenticated user's stored facts                                                                                |
| `hanzo ai memory list`     | List the authenticated user's memories, newest first                                                                      |
| `hanzo ai memory recall`   | Recall recent/relevant memories for context injection; with q it ranks semantically, without q it returns the most recent |
| `hanzo ai memory remember` | Store a memory for the authenticated user                                                                                 |
| `hanzo ai memory search`   | Search the authenticated user's memories (semantic, text fallback)                                                        |
| `hanzo ai memory update`   | Update one of the authenticated user's memories                                                                           |

### Messages

| Command                                         | What it does       |
| ----------------------------------------------- | ------------------ |
| `hanzo ai messages create`                      | Create a message   |
| `hanzo ai messages list`                        | List messages      |
| `hanzo ai messages owner answer <owner> <name>` | Answer (message)   |
| `hanzo ai messages owner get <owner> <name>`    | Retrieve a message |
| `hanzo ai messages owner rm <owner> <name>`     | Delete a message   |
| `hanzo ai messages owner set <owner> <name>`    | Replace a message  |
| `hanzo ai messages owner update <owner> <name>` | Update a message   |
| `hanzo ai messages welcome`                     | Welcome (message)  |

### Nodes

| Command                                             | What it does    |
| --------------------------------------------------- | --------------- |
| `hanzo ai nodes create`                             | Create a node   |
| `hanzo ai nodes list`                               | List nodes      |
| `hanzo ai nodes owner get <owner> <name>`           | Retrieve a node |
| `hanzo ai nodes owner rm <owner> <name>`            | Delete a node   |
| `hanzo ai nodes owner set <owner> <name>`           | Replace a node  |
| `hanzo ai nodes owner tunnel create <owner> <name>` | Tunnel (node)   |
| `hanzo ai nodes owner tunnel get <owner> <name>`    | Tunnel (node)   |
| `hanzo ai nodes owner update <owner> <name>`        | Update a node   |

### Org

| Command                              | What it does                                                                                                                                                   |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai org settings clear`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings create`       | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings get`          | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings list clear`   | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings list create`  | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings list get`     | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings list patch`   | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings list replace` | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings patch`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |
| `hanzo ai org settings replace`      | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]). |

### Preferences

| Command                        | What it does |
| ------------------------------ | ------------ |
| `hanzo ai preferences patch`   | Preferences  |
| `hanzo ai preferences replace` | Preferences  |

### Providers

| Command                                          | What it does                  |
| ------------------------------------------------ | ----------------------------- |
| `hanzo ai providers create`                      | Create a provider             |
| `hanzo ai providers global`                      | List providers across tenants |
| `hanzo ai providers list`                        | List providers                |
| `hanzo ai providers mcp-tools`                   | Mcp Tools (provider)          |
| `hanzo ai providers owner get <owner> <name>`    | Retrieve a provider           |
| `hanzo ai providers owner rm <owner> <name>`     | Delete a provider             |
| `hanzo ai providers owner set <owner> <name>`    | Replace a provider            |
| `hanzo ai providers owner update <owner> <name>` | Update a provider             |

### RAG

| Command                       | What it does                                                                                                                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai rag context`        | Return every stored chunk of one file\_id (full document context).                                                                                                                                                  |
| `hanzo ai rag delete`         | Delete all chunks of one or more uploaded files (by file\_id) from the owner's Search+Vector index.                                                                                                                 |
| `hanzo ai rag embed`          | Parse, chunk, and embed one uploaded file under its file\_id into the unified Search+Vector index, scoped to the authenticated owner.                                                                               |
| `hanzo ai rag ingest`         | Unified RAG ingest: parse + chunk + embed documents and pipe them to BOTH Hanzo Vector (semantic) AND Hanzo Search (keyword) under the tenant index {owner}-{store}-docs — the same index /v1/chat retrieval reads. |
| `hanzo ai rag query`          | Retrieve the top-K chunks relevant to a query, scoped to a single uploaded file (`file_id`).                                                                                                                        |
| `hanzo ai rag query-multiple` | Retrieve the top-K chunks relevant to a query, scoped to a SET of uploaded files (`file_ids`).                                                                                                                      |

### Records

| Command                                        | What it does           |
| ---------------------------------------------- | ---------------------- |
| `hanzo ai records batch`                       | Batch (record)         |
| `hanzo ai records commit`                      | Commit (record)        |
| `hanzo ai records commit-second`               | Commit Second (record) |
| `hanzo ai records create`                      | Create a record        |
| `hanzo ai records list`                        | List records           |
| `hanzo ai records owner get <owner> <name>`    | Retrieve a record      |
| `hanzo ai records owner rm <owner> <name>`     | Delete a record        |
| `hanzo ai records owner set <owner> <name>`    | Replace a record       |
| `hanzo ai records owner update <owner> <name>` | Update a record        |
| `hanzo ai records query`                       | Query (record)         |
| `hanzo ai records query-second`                | Query Second (record)  |

### Remote connections

| Command                                                   | What it does            |
| --------------------------------------------------------- | ----------------------- |
| `hanzo ai remote-connections create`                      | Create a connection     |
| `hanzo ai remote-connections list`                        | List remote-connections |
| `hanzo ai remote-connections owner get <owner> <name>`    | Retrieve a connection   |
| `hanzo ai remote-connections owner rm <owner> <name>`     | Delete a connection     |
| `hanzo ai remote-connections owner set <owner> <name>`    | Replace a connection    |
| `hanzo ai remote-connections owner start <owner> <name>`  | Start (connection)      |
| `hanzo ai remote-connections owner stop <owner> <name>`   | Stop (connection)       |
| `hanzo ai remote-connections owner update <owner> <name>` | Update a connection     |

### Router

| Command                                 | What it does                                                                                                                                                                                                                                               |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai router artifact-meta clear`   | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router artifact-meta create`  | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router artifact-meta get`     | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router artifact-meta patch`   | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router artifact-meta replace` | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router data clear`            | Router Data                                                                                                                                                                                                                                                |
| `hanzo ai router data get`              | Router Data                                                                                                                                                                                                                                                |
| `hanzo ai router defaults clear`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router defaults create`       | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router defaults get`          | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router defaults patch`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router defaults replace`      | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router history`               | Returns the router-improvement time-series.                                                                                                                                                                                                                |
| `hanzo ai router judge-panel`           | Returns the LIVE Mean-Field Judge Panel state: the configured panel + dynamic judge posture (enabled/sample) resolved from the "\*" GlobalDefaultOwner row, the live in-process per-judge calibration (weight/mean/n), and the static published benchmark. |
| `hanzo ai router ledger clear`          | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router ledger create`         | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router ledger get`            | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router ledger patch`          | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router ledger replace`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router policy clear`          | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router policy create`         | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router policy get`            | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router policy patch`          | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router policy replace`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router rewards clear`         | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router rewards create`        | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router rewards get`           | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router rewards patch`         | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router rewards replace`       | The HTTP transport binding for the RESTful router-config nouns (/v1/ai/router/{policy,defaults,ledger,rewards,artifact-meta} and /v1/ai/org/settings\[/list]).                                                                                             |
| `hanzo ai router stats`                 | Returns the router observability aggregate.                                                                                                                                                                                                                |

### Routes

| Command                                       | What it does           |
| --------------------------------------------- | ---------------------- |
| `hanzo ai routes create`                      | Create a model-route   |
| `hanzo ai routes list`                        | List routes            |
| `hanzo ai routes owner get <owner> <name>`    | Retrieve a model-route |
| `hanzo ai routes owner rm <owner> <name>`     | Delete a model-route   |
| `hanzo ai routes owner set <owner> <name>`    | Replace a model-route  |
| `hanzo ai routes owner update <owner> <name>` | Update a model-route   |

### Scales

| Command                                       | What it does               |
| --------------------------------------------- | -------------------------- |
| `hanzo ai scales create`                      | Create a scale             |
| `hanzo ai scales global`                      | List scales across tenants |
| `hanzo ai scales list`                        | List scales                |
| `hanzo ai scales owner get <owner> <name>`    | Retrieve a scale           |
| `hanzo ai scales owner rm <owner> <name>`     | Delete a scale             |
| `hanzo ai scales owner set <owner> <name>`    | Replace a scale            |
| `hanzo ai scales owner update <owner> <name>` | Update a scale             |
| `hanzo ai scales public`                      | Public (scale)             |

### Scans

| Command                                      | What it does    |
| -------------------------------------------- | --------------- |
| `hanzo ai scans create`                      | Create a scan   |
| `hanzo ai scans list`                        | List scans      |
| `hanzo ai scans owner get <owner> <name>`    | Retrieve a scan |
| `hanzo ai scans owner rm <owner> <name>`     | Delete a scan   |
| `hanzo ai scans owner set <owner> <name>`    | Replace a scan  |
| `hanzo ai scans owner update <owner> <name>` | Update a scan   |

### Sign-in sessions

| Command                                                | What it does         |
| ------------------------------------------------------ | -------------------- |
| `hanzo ai signin-sessions create`                      | Create a session     |
| `hanzo ai signin-sessions duplicated`                  | Duplicated (session) |
| `hanzo ai signin-sessions list`                        | List signin-sessions |
| `hanzo ai signin-sessions owner get <owner> <name>`    | Retrieve a session   |
| `hanzo ai signin-sessions owner rm <owner> <name>`     | Delete a session     |
| `hanzo ai signin-sessions owner set <owner> <name>`    | Replace a session    |
| `hanzo ai signin-sessions owner update <owner> <name>` | Update a session     |

### Stores

| Command                                        | What it does               |
| ---------------------------------------------- | -------------------------- |
| `hanzo ai stores create`                       | Create a store             |
| `hanzo ai stores global`                       | List stores across tenants |
| `hanzo ai stores list`                         | List stores                |
| `hanzo ai stores names`                        | Names (store)              |
| `hanzo ai stores owner get <owner> <name>`     | Retrieve a store           |
| `hanzo ai stores owner rm <owner> <name>`      | Delete a store             |
| `hanzo ai stores owner set <owner> <name>`     | Replace a store            |
| `hanzo ai stores owner update <owner> <name>`  | Update a store             |
| `hanzo ai stores owner vectors <owner> <name>` | Vectors (store)            |
| `hanzo ai stores providers`                    | Providers (store)          |

### Tasks

| Command                                        | What it does              |
| ---------------------------------------------- | ------------------------- |
| `hanzo ai tasks create`                        | Create a task             |
| `hanzo ai tasks global`                        | List tasks across tenants |
| `hanzo ai tasks list`                          | List tasks                |
| `hanzo ai tasks owner analyze <owner> <name>`  | Analyze (task)            |
| `hanzo ai tasks owner document <owner> <name>` | Document (task)           |
| `hanzo ai tasks owner get <owner> <name>`      | Retrieve a task           |
| `hanzo ai tasks owner rm <owner> <name>`       | Delete a task             |
| `hanzo ai tasks owner set <owner> <name>`      | Replace a task            |
| `hanzo ai tasks owner update <owner> <name>`   | Update a task             |

### Templates

| Command                                          | What it does        |
| ------------------------------------------------ | ------------------- |
| `hanzo ai templates create`                      | Create a template   |
| `hanzo ai templates list`                        | List templates      |
| `hanzo ai templates owner get <owner> <name>`    | Retrieve a template |
| `hanzo ai templates owner rm <owner> <name>`     | Delete a template   |
| `hanzo ai templates owner set <owner> <name>`    | Replace a template  |
| `hanzo ai templates owner update <owner> <name>` | Update a template   |

### Traffic

| Command                  | What it does                                                                                                                                                                                                                     |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo ai traffic globe` | Returns the PUBLIC live request-geo aggregate for the world.hanzo.ai "Hanzo mode" globe: WHERE requests to api.hanzo.ai are coming from, as country/region points with per-service-class counts, plus headline throughput rates. |

### Training contribution

| Command                                  | What it does          |
| ---------------------------------------- | --------------------- |
| `hanzo ai training-contribution get`     | Training Contribution |
| `hanzo ai training-contribution patch`   | Training Contribution |
| `hanzo ai training-contribution replace` | Training Contribution |

### Tree files

| Command                                           | What it does        |
| ------------------------------------------------- | ------------------- |
| `hanzo ai tree-files create`                      | Create a tree-file  |
| `hanzo ai tree-files owner rm <owner> <name>`     | Delete a tree-file  |
| `hanzo ai tree-files owner set <owner> <name>`    | Replace a tree-file |
| `hanzo ai tree-files owner update <owner> <name>` | Update a tree-file  |

### Usages

| Command                      | What it does       |
| ---------------------------- | ------------------ |
| `hanzo ai usages by-user`    | By User (usage)    |
| `hanzo ai usages cloud`      | Cloud (usage)      |
| `hanzo ai usages get`        | List usages        |
| `hanzo ai usages range`      | Range (usage)      |
| `hanzo ai usages user-names` | User Names (usage) |

### Vectors

| Command                                        | What it does                |
| ---------------------------------------------- | --------------------------- |
| `hanzo ai vectors all`                         | All (vector)                |
| `hanzo ai vectors create`                      | Create a vector             |
| `hanzo ai vectors global`                      | List vectors across tenants |
| `hanzo ai vectors list`                        | List vectors                |
| `hanzo ai vectors owner get <owner> <name>`    | Retrieve a vector           |
| `hanzo ai vectors owner rm <owner> <name>`     | Delete a vector             |
| `hanzo ai vectors owner set <owner> <name>`    | Replace a vector            |
| `hanzo ai vectors owner update <owner> <name>` | Update a vector             |

### Videos

| Command                                       | What it does               |
| --------------------------------------------- | -------------------------- |
| `hanzo ai videos create`                      | Create a video             |
| `hanzo ai videos global`                      | List videos across tenants |
| `hanzo ai videos list`                        | List videos                |
| `hanzo ai videos owner get <owner> <name>`    | Retrieve a video           |
| `hanzo ai videos owner rm <owner> <name>`     | Delete a video             |
| `hanzo ai videos owner set <owner> <name>`    | Replace a video            |
| `hanzo ai videos owner update <owner> <name>` | Update a video             |
| `hanzo ai videos upload`                      | Upload (video)             |

### Workflows

| Command                                          | What it does                  |
| ------------------------------------------------ | ----------------------------- |
| `hanzo ai workflows create`                      | Create a workflow             |
| `hanzo ai workflows global`                      | List workflows across tenants |
| `hanzo ai workflows list`                        | List workflows                |
| `hanzo ai workflows owner get <owner> <name>`    | Retrieve a workflow           |
| `hanzo ai workflows owner rm <owner> <name>`     | Delete a workflow             |
| `hanzo ai workflows owner set <owner> <name>`    | Replace a workflow            |
| `hanzo ai workflows owner update <owner> <name>` | Update a workflow             |
