Generate the HTML documentation from OpenAPI spec using Redoc

Directory of docs

Regenerating API Documentation

Modern Interactive API Docs (Recommended)

To regenerate the modern API documentation, run from the docs/ directory:

# Install dependencies (first time only)
npm install

# Generate the HTML documentation from OpenAPI spec using Redoc
npm run build-docs

OpenAPI Specification

The OpenAPI specification (docs/api-spec.yaml) is the source of truth for API documentation. This industry-standard format enables:

• Interactive documentation - Test endpoints directly in the browser
• SDK generation - Auto-generate client libraries for any programming language
• API validation - Ensure code matches documentation
• Integration tools - Import into Postman, Insomnia, API gateways, etc.

Important: When adding or modifying API endpoints, you must update docs/api-spec.yaml to keep documentation in sync:

1. Edit docs/api-spec.yaml with new endpoints, parameters, or response schemas
2. Run npm run build-docs to regenerate the HTML documentation
3. Commit both the YAML spec and generated HTML files