Docs — customer-facing documentation
Documentation is generated from each flagship's OpenAPI 3.1 spec. When the public docs site is live it serves at docs.szlholdings.com.
Public docs site: docs.szlholdings.com (MkDocs Material + neoteroi OpenAPI plugin). Until DNS is live, this embedded tree is the source of truth.
OpenAPI 3.1 per flagship
| Flagship | Base path | /openapi.json |
|---|---|---|
| a11oy | /api/a11oy | partial — pin 3.1, add Khipu components |
| amaru | /api/amaru | author full 3.1 |
| sentra | /api/sentra | author full 3.1 |
| killinchu | /api/killinchu | author 3.1 incl. /v1/cue |
| rosie | /api/rosie | partial — document public subset |
Doc tree
| Getting started | Install the SDK, mint an API key, make your first call |
| Authentication | API keys, scopes, per-flagship allowlists, cosign tamper-evidence — see /api-keys |
| SDKs | Python + TypeScript — see /sdk |
| The Khipu receipt | Every response carries a hash-chained receipt; chain_verified=false raises HaltError |
| Cued engagement | The Yachay-Dome /v1/cue product — see /cued-engagement |
Source: customer_surface/PUBLIC_DOCS_SITE.md · OPENAPI_SPECS_PER_FLAGSHIP.md