Versioning & deprecation

The API lives under /v1, and v1 is stable: fields and endpoints that shipped never change name, shape, or meaning within it.

Changes are additive: new endpoints, new optional parameters, new response fields. Your client must ignore fields it doesn't recognize — that is the compatibility contract, and it's what lets us keep improving the surface without breaking you. Additions are announced on the changelog.

If a breaking change ever becomes necessary, it ships as /v2 alongside /v1, with at least 12 months of overlap and direct notice to every active key holder before any v1 sunset.

The OpenAPI document is the canonical contract — the reference pages render from it, and its info.version tracks the current release.