Versioning
The API is not pinned to a version number yet. Additive fields and new endpoints can appear without notice; we avoid breaking existing fields and paths when we can.
When something does break, it is recorded in the changelog. Validate responses and handle errors rather than assuming a fixed shape forever.