Versioning

How to handle API versioning

List Pagination
Even though adding pagination support to an existing API is purely additive from API surface perspective, it is a behavior-breaking change
Versioning
Compatibility
This page provides more detailed explanations for the list of breaking and non-breaking changes given in the Versioning section.
Backwards-compatible (non-breaking) changes
Backwards-incompatible (breaking) changes