# /api/docs

API-specific documentation. Scoped to the proxy — anything that only affects the server side lives here.

Put here:

- Endpoint request/response schemas (per role, §4)
- Model routing table (role → model, per environment)
- Deploy notes (localhost → homelab VPS → fly.io, §4)
- Logging/eval-replay format (§10)
- Auth/metering design when it lands (§4)

Cross-cutting design (anything touching both client and api) goes in the root [`/docs`](../../docs), not here.