Project
The hanzo project commands.
Also for this capability: API · CLI · MCP · SDKs
Where your sites live: create one, deploy a build, roll back to any release.
hanzo project listEvery 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. |
Was this page useful?