When backwards-incompatible changes are made to the API, a new, dated version is released. The current version is 2023-01-01. Read our API upgrades guide to learn more about backwards compatibility. For all API updates, view our API changelog.

All requests use your account API settings, unless you override the API version. The upgrades guide lists every available version. Note that by default webhook events are structured according to your account API version, unless you set an API version during endpoint creation.

To set the API version on a specific request, send a DevRIFT-Version header.

You can visit your Dashboard to upgrade your API version. As a precaution, use API versioning to test a new API version before committing to an upgrade.

curl \
    -H "Authorization: Bearer {sk_test_foobar...}" \
    -H "DevRIFT-Version: 2023-01-01" \
    -D "-" \
    -X POST