How to handle API versioning
|Structured representations (application/json)|
Even though adding pagination support to an existing API is purely additive from API surface perspective, it is a behavior-breaking change
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|
|Guidelines for existing services and versioning of services|