Skip to content

Reference Overview

How the consumer API reference content is generated.

The reference section is generated from the consumer API worker-owned OpenAPI document.

  • Public API worker export: workers/consumer-api/src/docs/openapi.ts
  • Site generation script: apps/docs/scripts/generate-api-docs.ts

Each build writes:

  • Markdown reference page under src/content/docs/reference/consumer-api.md
  • Raw JSON spec under public/openapi/consumer-api.json

This keeps the documentation site as a consumer of API definitions instead of the place where endpoint details are maintained manually.