Versioning
Version 1 grows by adding things: new endpoints, new optional parameters, new response fields, new enum values and error codes. Ignore fields you do not know, and handle an unknown enum value or error code generically. Removing a field or changing its meaning is rare and never silent: the Apps it affects are told directly. Every change is listed in the Changelog, those ones marked Removed or Changed.