Docs development

Keep the Mintlify site aligned with the live FastAPI surface area.

Keep the API reference real

The API reference is generated from the live FastAPI OpenAPI schema.

. .venv/bin/activate
python scripts/export_openapi.py

If you need a non-local server in the playground:

OPENAPI_SERVER_URL=https://api.your-domain.com python scripts/export_openapi.py

Run the docs locally

From the Mintlify root:

cd docs/mintlify
mint dev

Validate before handoff

cd docs/mintlify
mint validate
mint broken-links