Skip to main content
The public API is versioned in the URL path. Current public endpoints live under /v1. The generated OpenAPI document is the source for endpoint signatures, operation IDs, request schemas, response schemas, and examples. Route behavior must not be documented as available until the public HTTP route exists and the generated spec includes it. Backward-compatible schema additions can be added to /v1. Breaking changes require a new API version or an explicit deprecation path in the OpenAPI metadata.