Versioning policy
The REST API is versioned by URL prefix (`/api/v1`, and eventually `/api/v2`). v1 is frozen-additive: existing fields, endpoints, and behavior never change or disappear — only new, optional fields and new endpoints are added. A pinned integration built against v1 today keeps working indefinitely.
A genuinely breaking change (removing a field, changing a type, altering existing behavior) ships as a new version prefix instead of mutating v1 — you opt in by changing the URL, on your own schedule.
Changelog
New entries are appended to the top of this list as the v1 surface grows — additive changes (new fields, new endpoints) do not get their own entry unless they introduce a new resource.