#breaking API changes

API Versioning Done Right: How to Evolve Your API Without Breaking Your Clients

Every API that survives long enough becomes a versioning problem. You ship v1. Users build on it. Six months later you need to change a response shape...