Introducing Support for Focus Areas features

📘

API updates are incremental!

By adding the new request header (see section "Accessing the New Version" below) for this update, you will automatically include updates from past API versions (i.e. 2021-05-03).

Overview

We have released an update to the Ribbon API that replaces the existing conditions reference endpoint with a new one that is a part of our Focus Areas product.

In order to switch between the two versions of the /conditions/ endpoint, you must include a header variable in your API request:

• Ribbon-Version = 2021-05-03 for the new conditions endpoint
  
• Ribbon-Version = 2019-11-19 for the existing conditions endpoint
  

If you are not currently dependent on the existing conditions endpoint, we recommend using the newer API version as it will ensure the least amount of potential migration necessary to future versions of the API.

However, depending on your use case, we can set one or the other as your default API version, so you only need to use the header for the non-default use case.

Please contact us for more information about this and to make sure your default is set correctly!

🚧

Add Ribbon-Version: 2021-05-03 to every request header or email [email protected]

After you complete testing with the updated version, feel free to let us know and will set your entire API to this version. Email us at [email protected]

Alternatively, you can add Ribbon-Version: 2021-05-03 to every request header.

Note: a user interface to toggle API versions is in the works!