Skip to content

Versioning

The version is in the path: /v1. It only changes additively: new operations, new optional fields, new event types, new enum values. Ignore fields you do not know.

A removal or an incompatible change is announced at least 12 months ahead: the operation answers Deprecation (RFC 9745), Sunset (RFC 8594, the removal date) and a Link to its migration guide, and the changelog lists it. Breaking changes are blocked in our CI against the published contract.