Hanzo
OpenapiTemplate

Lists the public starter-kit catalog plus, for a validated caller, that org's…

Lists the public starter-kit catalog plus, for a validated caller, that org's own private kits.

GET /v1/template

Addresshttps://api.hanzo.ai/v1/template
MethodGET
Operationget_template
AuthAuthorization: Bearer $HANZO_API_KEY

Lists the public starter-kit catalog plus, for a validated caller, that org's own private kits. No request field can widen the scope: the org comes from the validated principal, so an anonymous or cross-org caller structurally sees the public catalog only.

Request

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

Response

StatusBodyMeaning
200kitListok

200 body — 20 fields.

FieldInTypeAlwaysDescription
databodyStarterKit[]Data is the public catalog followed by the caller org's own kits.
data[].categorybodystringgroups the kit in the gallery browser ("Portfolio", "SaaS")
data[].demobodystringlive demo (<slug>.hanzo.app), when deployed
data[].descriptionbodystringthe browse-card blurb
data[].featuresbodystring[]the highlights the card lists, at most 32
data[].frameworkbodystringthe stack the kit is built on ("Next.js 14.2 + TS")
data[].orgbodystringowner of a PRIVATE template; empty in the public catalog
data[].previewbodystringthe still image the browse card renders
data[].ratingbodynumberRating is public-gallery curation, on the same terms as Tier: catalog-only, never accepted from a request, absent on a customer's own kit.
data[].slugbodystringthe kit's identity — lowercase alphanumeric with dashes, max 40
data[].sourcebodystringthe repository the kit is forked from
data[].tierbodyintegerTier is public-gallery curation, carried verbatim from the embedded catalog.
data[].titlebodystringdisplay name
data[].useCasebodystringwhat the kit is for, in a phrase
data[].variantsbodyVariant[]the shapes this template ships in
data[].variants[].frameworkbodystringonly when it differs from the template's
data[].variants[].idbodystringselector, unique within the template ("react", "grid-3-fluid")
data[].variants[].kindbodystringthe axis it varies: format | page | theme
data[].variants[].labelbodystringhuman label for the picker
data[].variants[].sourcebodystringthe repository this shape is forked from; the synthesized default shape carries the template's own

Failure carries the platform error shape — see Errors.

Examples

hanzo templates list

Template API · All Hanzo APIs · Interactive reference

How is this guide?

On this page