Skip to main content
The version is in the path. Every endpoint today is under /v1.

Changes we make within a version

We add to v1 without notice. Build your integration so these changes don’t break it:

Breaking changes

These changes never happen within a version:
  • removing or renaming an endpoint, a field or a value,
  • changing a field’s type or meaning,
  • making an optional request field required,
  • changing the status code or error code for an outcome.
A breaking change comes in a new version, such as /v2, and we tell you in advance. We record changes in the changelog.