Introducing API versioning!

The moment we’ve all been waiting for is finally here :drum:

We just implemented API versioning as a powerful way to continuously improve our API while providing a stable API for our third-party developers!

Check out our API versioning guide for more info and examples, but in the meantime, here are a few answers to the most frequently asked questions!

What versions do you support?

We support three different API versions: stable , deprecated , and preview. Each quarter, we will release updated versions that contain new features, updates, bug fixes, or deprecations.

What are the current versions?

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

How do I access a specific version?

All you need to do is send the API-Version header in your request (here’s an example!)

How do I know what is different in each version?

As always, you can see any changes or updates to the API here in the community or in our changelog. We will also share release notes about each version when they are released.

Anything else?

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.

If you have any questions, feel free to post them in the community!

Happy versioning :star_struck:

1 Like

2 posts were split to a new topic: Allow referencing API version by name – stable, preview, or deprecate-d