API Versioning

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 'Coil-Version': '2019-03-25'.

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' \
-d '&grant_type=authorization_code'