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.
API reference →
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 createCreates a project — the handle a site is deployed and served under — and answers 201 with it in draft. hanzo project edgehealth reports whether a publish reaches readers, rather than whether it was accepted. hanzo project forkCreates a project seeded from a PUBLISHED EXAMPLE — either a starter-kit template from the ONE embedded gallery… hanzo project listReturns every project your org owns. hanzo project tagsThe site's browser tag set for the hosted tag — which pixels to inject, by publishable key hanzo projects createCreates a project — the handle a site is deployed and served under — and answers 201 with it in draft. hanzo projects edgehealth reports whether a publish reaches readers, rather than whether it was accepted. hanzo projects forkCreates a project seeded from a PUBLISHED EXAMPLE — either a starter-kit template from the ONE embedded gallery… hanzo projects listReturns every project your org owns.
Command What it does hanzo project deploy <slug>Upload a built site as one archive and serve it hanzo projects deploy <slug>Upload a built site as one archive and serve it
Command What it does hanzo project deployments complete <slug> <id>CompleteDeployment is the CI completion hook that flips a queued git deployment to live (or error) once CI has synced… 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>CompleteDeployment is the CI completion hook that flips a queued git deployment to live (or error) once CI has synced… 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.
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… 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…
Command What it does hanzo project get <slug>Returns one project of yours by slug — its settings, its live URL and the deployment currently serving it. hanzo projects get <slug>Returns one project of yours by slug — its settings, its live URL and the deployment currently serving it.
Command What it does 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 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.
Command What it does hanzo project purge <slug>Flushes the site's edge cache without redeploying anything. hanzo projects purge <slug>Flushes the site's edge cache without redeploying anything.
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… 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… hanzo projects releases list <slug>Returns a site's releases newest-first, marking the active one — the rollback menu.
Command What it does hanzo project rm <slug>Deletes a project and takes its site off the internet. hanzo projects rm <slug>Deletes a project and takes its site off the internet.
Command What it does hanzo project shot <slug>Get a PNG of the project's live site hanzo projects shot <slug>Get a PNG of the project's live site
Command What it does hanzo project sites createGenerates a self-contained, mobile-responsive static site from a natural-language brief and deploys it live in one call. hanzo project sites deployDeploys a caller-supplied file manifest — the deploy_site capability an agent calls — and answers with where it went… hanzo project sites get <slug>Returns one site — the same row ListSites carries, for one slug. hanzo project sites listReturns the org's deployed sites at the pretty URLs they serve at. hanzo projects sites createGenerates a self-contained, mobile-responsive static site from a natural-language brief and deploys it live in one call. hanzo projects sites deployDeploys a caller-supplied file manifest — the deploy_site capability an agent calls — and answers with where it went… hanzo projects sites get <slug>Returns one site — the same row ListSites carries, for one slug. hanzo projects sites listReturns the org's deployed sites at the pretty URLs they serve at.
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.
Command What it does hanzo project update <slug>Changes a project's settings, and only the settings you send. hanzo projects update <slug>Changes a project's settings, and only the settings you send.
How is this guide?