Versioning
- The version is in the URL (
/v1). - New fields and routes can appear at any time. Ignore fields you don’t recognize, and handle new enum values (statuses, event types) without breaking.
- A change that breaks integrations becomes
/v2, and/v1keeps working for at least 6 months after the announcement. - Everything that changed is in the Changelog.