New release: API versioning

We now will use versioning to provide a stable API to our third-party developers while simultaneously allowing the API to evolve and improve!

We support three different versions of the API: stable, deprecated, and preview. Each quarter, we will release updated versions that contain new features, updates, bug fixes, or deprecations. To access a specific version, you can send the API-Version header in your request (check out an example here!)

Current versions

  • Stable: 2023-04
  • Deprecated: 2023-01
  • Preview: 2023-07

Further, we’ve also added the version and versions APIs that you can query to retrieve information about the version you used in your request or all of the currently supported versions.

Check out our guide for more information about API versioning!