Hanzo
OpenapiLicensing

Reads one release's metadata: its product, version, platform and the cosign…

Reads one release's metadata: its product, version, platform and the cosign material a client verifies the binary against. An unknown id is 404.

GET /v1/licensing/releases/{release}

Addresshttps://api.hanzo.ai/v1/licensing/releases/{release}
MethodGET
Operationget_licensing_releases_by_release
AuthAuthorization: Bearer $HANZO_API_KEY

Reads one release's metadata: its product, version, platform and the cosign material a client verifies the binary against.

An unknown id is 404. Like the list, this is metadata only — the bytes are behind the license-gated download.

Request

1 field.

FieldInTypeRequiredDescription
releasepathstringyes

Response

StatusBodyMeaning
200licensing.Releaseok

200 body — 12 fields.

FieldInTypeAlwaysDescription
app_idbodystringAppID scopes the release to an app build ("hanzo" | "lux" | "zoo").
artifact_refbodystringArtifactRef is where the binary lives (object-store key / OCI ref / path).
cosign_certbodystringCosignCert is the cosign/Fulcio cert (keyless) or public key ref used to verify CosignSignature.
cosign_signaturebodystringCosignSignature is the base64 cosign signature over the artifact digest.
created_atbodyinteger
idbodystringID is the release identifier, e.g. "engine-rocm-0.4.2-linux-amd64".
min_featuresbodystring[]MinFeatures, when set, are features the license must include to download.
platformbodystringPlatform is "<os>/<arch>", e.g.
productbodystringProduct is the licensed product this artifact belongs to (commerce SKU): "engine" for every one of those builds.
sha256bodystringSHA256 is the hex digest of the artifact (integrity + cosign subject).
versionbodystringVersion is the semantic version of the binary.
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 get <release>

Licensing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page