Current status
OpenAPI-backed rendering for the public REST family is active.Generated-reference chain
| Layer | Current role |
|---|---|
packages/exchange-api/public/swagger.json | Exchange REST source artifact |
packages/stats/public/swagger.json | Stats REST source artifact |
packages/api-docs/merged/unified-swagger.json | Unified public REST source artifact |
docs/api-specs/public-rest-unified.json | Mintlify render bundle derived from the unified Swagger plus vendored schema definitions |
| Generated REST pages under Generated REST Endpoints | Public endpoint-by-endpoint rendering layer |
What this means
- the package-owned public REST Swagger artifacts remain authoritative
- Mintlify renders the endpoint surface from
docs/api-specs/public-rest-unified.json, a derived bundle built from the unified public Swagger plus vendored schema definitions - manual support pages still own quickstart, auth posture, examples, and error-handling guidance
What generated pages own versus manual pages
| Need | Use |
|---|---|
| exact request and response shapes, parameters, and endpoint lookup | Generated REST Endpoints |
| integration entry flow | REST Quickstart |
| signing and write-path posture | REST Authentication |
| retry and backoff planning | REST Rate Limits |
| failure interpretation | REST Errors and Error Reference |
| source-of-truth lineage | REST Source Artifacts |