Versioning

Versioning and stability

The repository currently exposes the public contract at /api/public/v1. The documentation treats v1 as the current stable public surface.

Current version
v1
Base path
/api/public/v1
Contract source
OpenAPI 3.1
Stability
Documented v1 surface

Versioning expectations

  • Use the /api/public/v1 base path for all documented routes.
  • Treat the published OpenAPI document as the machine-readable contract for the current public surface.
  • If your integration depends on specific behaviors, pin against this documented v1 contract and monitor release changes.
  • The repository does not define a separate public changelog system yet, so this portal documents the currently supported stable surface.