Our OAuth and User APIs are versioned by date in
YYYY-MM-DD format. The version is included in the
Coil-Version header. If a header isn't provided, then the latest version is used.
If you want to pin your app to an API version, we recommend pinning it to the date you first accessed an API. For example, if you first accessed an API on March 25, 2019, then the header would contain
In all example requests throughout the documentation, assume a version header is present if you want to pin your app to an API version.
Example versioned request for an access token refresh
curl -X POST https://coil.com/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Coil-Version: 2019-03-25" \
-H "Authorization: Basic MzE0YWMxMzQt...ZmMzYy00ZDI4U=" \
-d 'code=CU6LG36vKvVmUbF9QWFwj7F5zvY' \