Projects The `hanzo projects` commands.
Also for this capability: API · CLI · 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 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. hanzo projects tagsThe site's browser tag set for the hosted tag — which pixels to inject, by publishable key
Command What it does hanzo projects deploy <slug>Upload a built site as one archive and serve it
Command What it does 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 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 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 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 projects purge <slug>Flushes the site's edge cache without redeploying anything.
Command What it does 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 projects rm <slug>Deletes a project and takes its site off the internet.
Command What it does hanzo projects shot <slug>Get a PNG of the project's live site
Command What it does 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 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 projects update <slug>Changes a project's settings, and only the settings you send.
How is this guide?