Versioning
SDK versioning
New releases of SDKs will follow the Semantic versioning spec to ensure our SDK ecosystem is reliable.
See NPM's description on Semantic versioning if you are unfamiliar with the concept.
HTTP API versioning
We are still evolving our HTTP API on a regular basis. As such we cannot guarantee the same semantic compliance with our HTTP API as with our SDKs.
When possible we recommend consuming our SDKs instead of the HTTP API directly.