Kondable API deprecation policy

The public JSON API is versioned in the URL path as /api/v1/. The current major version is 1.

How versions work

/api/v1/ is the contract agents should call.
Breaking changes ship as /api/v2/. Additive fields and new operations on v1 are not breaking.
Unversioned shortcuts such as /openapi.json and /llms.txt are discovery files, not a second contract.

When a version will be removed, Kondable announces it at least twelve months in advance:

The Deprecation HTTP header is set to true on that version's responses.
The Sunset HTTP header carries the HTTP-date after which the version may disappear.
This page and /api/v1 are updated with the same date.

Until a Sunset date is published, v1 is current and those headers are absent.