OpenAPI spec¶
The HTTP contract between app/ and agents/ is
api/openapi.yaml.
app/src/lib/api-types.tsis generated (npm run gen:api).agents/src/onehealth_agents/api/models.pyis validated against the spec.- Never hand-edit
api-types.ts.
CI validates the spec on every change:
bash
redocly lint api/openapi.yaml
redocly preview-docs api/openapi.yaml