Hanzo
OpenapiProjects

Returns a site's releases newest-first, marking the active one — the rollback…

Returns a site's releases newest-first, marking the active one — the rollback menu.

GET /v1/projects/{slug}/releases

Addresshttps://api.hanzo.ai/v1/projects/{slug}/releases
MethodGET
Operationget_projects_by_slug_releases
AuthAuthorization: Bearer $HANZO_API_KEY

Returns a site's releases newest-first, marking the active one — the rollback menu.

Each row carries the release id to activate, the source it was promoted from, its object and byte counts, and the URL if it is the one serving. Retention bounds the list, so it is the set that can actually still be rolled back to, not a full history.

Scope: a validated principal is required (403 without one) and the site is resolved within that principal's org, so another tenant's slug is a 404.

Request

1 field.

FieldInTypeRequiredDescription
slugpathstringyesSlug is the project to act on, from the path.

Response

StatusBodyMeaning
200projectsRelease[]ok

200 body — 8 fields.

FieldInTypeAlwaysDescription
[].activebodybooleanActive is whether this is the release the site is SERVING right now.
[].bytesbodyintegerBytes is their total size in bytes.
[].createdAtbodyintegerCreatedAt is when the release was cut, as Unix seconds — not when it was last activated.
[].objectsbodyintegerObjects is how many files the release holds.
[].releaseIdbodystringReleaseID is derived from a DIGEST of the release's own manifest, so identical content is the same release and a release can never be confused with another…
[].slugbodystringSlug is the site this release belongs to.
[].sourcebodystringSource is what the release was cut from — the build output or upload it was promoted out of.
[].urlbodystringURL is where the site serves.

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