Hanzo
OpenapiLicensing

Lists the signed binary releases this deployment can serve.

Lists the signed binary releases this deployment can serve.

GET /v1/licensing/releases

Addresshttps://api.hanzo.ai/v1/licensing/releases
MethodGET
Operationget_licensing_releases
AuthAuthorization: Bearer $HANZO_API_KEY

Lists the signed binary releases this deployment can serve.

Metadata only, and no download URL: the artifact is behind GET /v1/licensing/download/{release}, which is gated on a valid license token. Knowing that a release exists is not permission to run it, which is why this list needs no license of its own.

Request

GET /v1/licensing/releases takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200licensing.ReleaseListok

200 body — 13 fields.

FieldInTypeAlwaysDescription
releasesbodylicensing.Release[]Releases is the published releases, always an array and never null.
releases[].app_idbodystringAppID scopes the release to an app build ("hanzo" | "lux" | "zoo").
releases[].artifact_refbodystringArtifactRef is where the binary lives (object-store key / OCI ref / path).
releases[].cosign_certbodystringCosignCert is the cosign/Fulcio cert (keyless) or public key ref used to verify CosignSignature.
releases[].cosign_signaturebodystringCosignSignature is the base64 cosign signature over the artifact digest.
releases[].created_atbodyinteger
releases[].idbodystringID is the release identifier, e.g. "engine-rocm-0.4.2-linux-amd64".
releases[].min_featuresbodystring[]MinFeatures, when set, are features the license must include to download.
releases[].platformbodystringPlatform is "<os>/<arch>", e.g.
releases[].productbodystringProduct is the licensed product this artifact belongs to (commerce SKU): "engine" for every one of those builds.
releases[].sha256bodystringSHA256 is the hex digest of the artifact (integrity + cosign subject).
releases[].versionbodystringVersion is the semantic version of the binary.
releases[].yankedbodybooleanYanked marks a pulled release (download refused; tokens may be revoked release-scoped too).

Failure carries the platform error shape — see Errors.

Examples

hanzo licensing releases list

Licensing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page