Versioning & deprecation

The path version /api/v1 is the contract.

Path version

Backwards-compatible additions (new fields, new endpoints) appear within v1. Breaking changes only ship as v2.

Deprecated endpoints carry Deprecation, Sunset and Link headers pointing to the migration — at least twelve months before shutdown.

http

Deprecation: @1788480000
Sunset: Sat, 06 Sep 2027 00:00:00 GMT
Link: <https://www.claritos.io/developers/changelog>; rel="deprecation"

Every change is in the changelog with version and date. The OpenAPI file carries the same version.