OpenAPI v1¶
- Canonical contract:
api/v1/schema.yaml(human-reviewed, versioned) - Generated artifact:
api/v1/openapi.v1.json(derived; do not edit manually)
Use the schema to generate clients or validate requests/responses. Breaking changes require a new API version.