API versioning

A time comes in an API's life where one needs to make a breaking change. That time has officially come, and we've introduced API versioning to handle it.

As of today, we have two API versions: 2024-07-01 and 2024-08-01. Anyone who's ever made an external API request is on the former; everyone else (including all new accounts) is on the latter.

No action is required to fix your integration; the approach we've taken (heavily inspired by Stripe's) means that your code will be safe in perpetuity, and we'll always transform any incoming requests or outgoing responses to make sure we're sending what you expect.

Fascinated? Want to learn more?

1. Read our official documentation on versioning.
2. Check out the breaking change that warranted it all.