Catalog
Package catalog is one place to browse every project, app and site built here.
Package catalog is one place to browse every project, app and site built here.
| Base URL | https://api.hanzo.ai |
| Operations | 8 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
catalog
put_v1_catalog_entries_by_wildcard1
PUT /v1/catalog/entries/{wildcard1}
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
wildcard1 | path | string | yes |
delete_v1_catalog_entries_by_wildcard1
DELETE /v1/catalog/entries/{wildcard1}
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
wildcard1 | path | string | yes |
get_v1_catalog_entries
GET /v1/catalog/entries
post_v1_catalog_entries
POST /v1/catalog/entries
post_v1_catalog_models_refresh
POST /v1/catalog/models/refresh
post_v1_catalog_models
POST /v1/catalog/models
post_v1_catalog_seed
POST /v1/catalog/seed
Browse searches AND browses the cross-org catalog: every project, app and site the fleet has built, whichever org built it.
GET /v1/catalog
Browse searches AND browses the cross-org catalog: every project, app and site the fleet has built, whichever org built it.
It reads TWO corpora and returns them as one page — the published,
world-readable catalog that every caller sees, plus the caller's OWN org's
private entries when the request carries a validated principal. Each row says
which it came from in scope, so a client can warn before sharing a link. An
anonymous caller simply gets the published one; no filter can ever widen a
caller into another tenant's corpus, because the query that would return it is
never run for them.
A request with no q is a browse rather than a search, and both answer the same shape: the page, the total before paging, and the facet counts over the whole matching set.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
q | query | string | — | Q is the free-text query the lexical index scores relevance on. |
org | query | string | — | Org narrows to one builder org: hanzo | lux | zoo. |
kind | query | string | — | Kind narrows to repo | site. |
origin | query | string | — | Origin narrows to what a row IS to you: template | community | third-party | product. |
archetype | query | string | — | Archetype narrows to one project archetype. |
language | query | string | — | Language narrows to one implementation language. |
template | query | string | — | Template narrows a lane to ONE lineage: the id of the parent everything returned was forked from. |
forkable | query | string | — | Forkable is tri-state: "true" selects the forkable rows, "false" selects the rest, and anything else — including absent |
limit | query | string | — | Limit caps the page at 200, default 50. |
offset | query | string | — | Offset is where the page starts, default 0, with the same tolerance. |
How is this guide?