# Project

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

> The `hanzo project` commands.

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

Where your sites live: create one, deploy a build, roll back to any release.

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

```bash
hanzo project 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 project create`          | Creates a project — the handle a site is deployed and served under — and answers 201 with it in `draft`.                                                                                                                                                 |
| `hanzo project deploy <slug>`   | Upload a built site as one archive and serve it                                                                                                                                                                                                          |
| `hanzo project edge`            | health reports whether a publish reaches readers, rather than whether it was accepted.                                                                                                                                                                   |
| `hanzo project fork`            | Creates a project seeded from a PUBLISHED EXAMPLE — either a starter-kit template from the ONE embedded gallery catalog, or any live project on the platform (an example a seeded creator published, or another org's app serving at \<slug>.hanzo.app). |
| `hanzo project get <slug>`      | Returns one project of yours by slug — its settings, its live URL and the deployment currently serving it.                                                                                                                                               |
| `hanzo project list`            | Returns every project your org owns.                                                                                                                                                                                                                     |
| `hanzo project publish <slug>`  | Promotes a build output into a new release AND goes live with it — create+activate in one call, which is the 99% path.                                                                                                                                   |
| `hanzo project purge <slug>`    | Flushes the site's edge cache without redeploying anything.                                                                                                                                                                                              |
| `hanzo project rm <slug>`       | Deletes a project and takes its site off the internet.                                                                                                                                                                                                   |
| `hanzo project shot <slug>`     | Get a PNG of the project's live site                                                                                                                                                                                                                     |
| `hanzo project tags`            | The site's browser tag set for the hosted tag — which pixels to inject, by publishable key                                                                                                                                                               |
| `hanzo project update <slug>`   | Changes a project's settings, and only the settings you send.                                                                                                                                                                                            |
| `hanzo projects create`         | Creates a project — the handle a site is deployed and served under — and answers 201 with it in `draft`.                                                                                                                                                 |
| `hanzo projects deploy <slug>`  | Upload a built site as one archive and serve it                                                                                                                                                                                                          |
| `hanzo projects edge`           | health reports whether a publish reaches readers, rather than whether it was accepted.                                                                                                                                                                   |
| `hanzo projects fork`           | Creates a project seeded from a PUBLISHED EXAMPLE — either a starter-kit template from the ONE embedded gallery catalog, or any live project on the platform (an example a seeded creator published, or another org's app serving at \<slug>.hanzo.app). |
| `hanzo projects get <slug>`     | Returns one project of yours by slug — its settings, its live URL and the deployment currently serving it.                                                                                                                                               |
| `hanzo projects list`           | Returns every project your org owns.                                                                                                                                                                                                                     |
| `hanzo projects publish <slug>` | Promotes a build output into a new release AND goes live with it — create+activate in one call, which is the 99% path.                                                                                                                                   |
| `hanzo projects purge <slug>`   | Flushes the site's edge cache without redeploying anything.                                                                                                                                                                                              |
| `hanzo projects rm <slug>`      | Deletes a project and takes its site off the internet.                                                                                                                                                                                                   |
| `hanzo projects shot <slug>`    | Get a PNG of the project's live site                                                                                                                                                                                                                     |
| `hanzo projects update <slug>`  | Changes a project's settings, and only the settings you send.                                                                                                                                                                                            |

### Deployments

| Command                                           | What it does                                                                                                          |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `hanzo project deployments complete <slug> <id>`  | The CI completion hook that flips a queued git deployment to live (or error) once CI has synced the built site to S3. |
| `hanzo project deployments create <slug>`         | Opens a deployment and hands back a short-lived, prefix-scoped grant to write its bytes straight to object storage.   |
| `hanzo project deployments get <slug> <id>`       | Returns one deployment of a project by id.                                                                            |
| `hanzo project deployments list <slug>`           | Returns a project's deploy history, newest version first.                                                             |
| `hanzo projects deployments complete <slug> <id>` | The CI completion hook that flips a queued git deployment to live (or error) once CI has synced the built site to S3. |
| `hanzo projects deployments create <slug>`        | Opens a deployment and hands back a short-lived, prefix-scoped grant to write its bytes straight to object storage.   |
| `hanzo projects deployments get <slug> <id>`      | Returns one deployment of a project by id.                                                                            |
| `hanzo projects deployments list <slug>`          | Returns a project's deploy history, newest version first.                                                             |

### Domains

| Command                                       | What it does                                                                                                                    |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo project domains create <slug>`         | Attaches one or more CUSTOM public hostnames to this org's site.                                                                |
| `hanzo project domains list <slug>`           | Returns every custom hostname this site holds: the live ones, plus any pending claim with the DNS records it still owes.        |
| `hanzo project domains rm <slug> <host>`      | Gives a custom hostname back, so the name is free to reuse.                                                                     |
| `hanzo project domains verify <slug> <host>`  | Checks the DNS challenge for a pending custom hostname and, when it passes, promotes the host so it begins routing at the edge. |
| `hanzo projects domains create <slug>`        | Attaches one or more CUSTOM public hostnames to this org's site.                                                                |
| `hanzo projects domains list <slug>`          | Returns every custom hostname this site holds: the live ones, plus any pending claim with the DNS records it still owes.        |
| `hanzo projects domains rm <slug> <host>`     | Gives a custom hostname back, so the name is free to reuse.                                                                     |
| `hanzo projects domains verify <slug> <host>` | Checks the DNS challenge for a pending custom hostname and, when it passes, promotes the host so it begins routing at the edge. |

### Releases

| Command                                             | What it does                                                                                                                                                       |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo project releases activate <slug> <release>`  | Points the site at an existing release — the go-live, and equally the ROLLBACK.                                                                                    |
| `hanzo project releases create <slug>`              | Promotes a build output into a new immutable release WITHOUT serving it — the staged half of publishing, for when you want to check a release before it goes live. |
| `hanzo project releases list <slug>`                | Returns a site's releases newest-first, marking the active one — the rollback menu.                                                                                |
| `hanzo projects releases activate <slug> <release>` | Points the site at an existing release — the go-live, and equally the ROLLBACK.                                                                                    |
| `hanzo projects releases create <slug>`             | Promotes a build output into a new immutable release WITHOUT serving it — the staged half of publishing, for when you want to check a release before it goes live. |
| `hanzo projects releases list <slug>`               | Returns a site's releases newest-first, marking the active one — the rollback menu.                                                                                |

### Sites

| Command                           | What it does                                                                                                                |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `hanzo project sites create`      | Generates a self-contained, mobile-responsive static site from a natural-language brief and deploys it live in one call.    |
| `hanzo project sites deploy`      | Deploys a caller-supplied file manifest — the deploy\_site capability an agent calls — and answers with where it went live. |
| `hanzo project sites get <slug>`  | Returns one site — the same row ListSites carries, for one slug.                                                            |
| `hanzo project sites list`        | Returns the org's deployed sites at the pretty URLs they serve at.                                                          |
| `hanzo projects sites create`     | Generates a self-contained, mobile-responsive static site from a natural-language brief and deploys it live in one call.    |
| `hanzo projects sites deploy`     | Deploys a caller-supplied file manifest — the deploy\_site capability an agent calls — and answers with where it went live. |
| `hanzo projects sites get <slug>` | Returns one site — the same row ListSites carries, for one slug.                                                            |
| `hanzo projects sites list`       | Returns the org's deployed sites at the pretty URLs they serve at.                                                          |

### Star

| Command                              | What it does                                                                                    |
| ------------------------------------ | ----------------------------------------------------------------------------------------------- |
| `hanzo project star clear <slug>`    | Removes the caller's own bookmark from a project, and answers whether it is starred afterwards. |
| `hanzo project star replace <slug>`  | Bookmarks a project for the person calling, and answers whether it is starred afterwards.       |
| `hanzo projects star clear <slug>`   | Removes the caller's own bookmark from a project, and answers whether it is starred afterwards. |
| `hanzo projects star replace <slug>` | Bookmarks a project for the person calling, and answers whether it is starred afterwards.       |