Hanzo
OpenapiProjects

Returns the org's deployed sites at the pretty URLs they serve at.

Returns the org's deployed sites at the pretty URLs they serve at.

GET /v1/projects/sites

Addresshttps://api.hanzo.ai/v1/projects/sites
MethodGET
Operationget_projects_sites
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the org's deployed sites at the pretty URLs they serve at.

It reads the SAME org-scoped store as /v1/projects and keeps only the projects that are actually live, so a draft or a failed build is not advertised as a site.

Scope: a validated principal is required (403 without one) and the list is keyed by that principal's org.

Request

GET /v1/projects/sites takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200projectsSite[]ok

200 body — 5 fields.

FieldInTypeAlwaysDescription
[].namebodystringName is the site's display name.
[].slugbodystringSlug is the site's handle — also the label of the host it serves at.
[].statusbodystringStatus is the project's state behind the site — whether it is serving, still building, or failed its last build.
[].updatedAtbodyintegerUpdatedAt is when the project last changed, as Unix seconds.
[].urlbodystringURL is the pretty address readers use, not the object-store path behind it.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Projects API · All Hanzo APIs · Interactive reference

How is this guide?

On this page