API Version

v3 is the only supported version.

v3 is the only supported version. Every path starts with /v3/. There is no version header and nothing to pin.

How the API changes

Kind of changeHow it shipsWhat you should do
Additive: a new field, a new status, a new endpointWithout a version changeWrite handlers that ignore fields and statuses they do not recognize
BreakingAnnounced in the Changelog with an effective dateFollow the changelog entry before that date

v1 and v2 are retired. If you are still on either, the migration guides are in the Changelog.