Transitioning from Docebo’s 6.9 APIs

Learn more about transitioning from the 6.9 APIs to the 7.0 APIs

Last Updated

April 11th, 2019

Reading Time

3 min

User Level

Introduction

The Docebo 6.9 API set has a set End of Life date on July 31, 2019. Until this date, the APIs are still fully available for use in your platform and will continue working up until the End of Life Date. The 6.9 API set is being replaced by a new set enhanced of APIs that support most of the old functionality. This article outlines everything you need to know about your transition from the 6.9 API set to the 7.0 API set. For more information about our APIs, refer to this documentation.

What is the change?

Currently, you can use 6.9 API libraries found here https://<yourplatformname.docebosaas.com>/api/docs#. As of June 2018, the 6.9 Docebo API endpoints have been deprecated by Docebo. The 6.9 API endpoints have an End of Life date of July 31, 2019, so any 6.9 API endpoints used by your developers will need to be changed to 7.0 Docebo API libraries prior to this date. The version 7 API browser can be found on your platform by going to https://<yourplatformname.docebosaas.com>/api-browser/

Why are we retiring the 6.9 API set?

As the Docebo platform evolved, it was necessary to refactor the API set in order to provide better performance and additional flexibility in the endpoints available. As we continue to build out the 7.0 API set, it is necessary to phase out the 6.9 API set.

What actions should I take?

Update your integrations to use the API endpoints found at https://<yourplatformname.docebosaas.com>/api-browser/. Additionally, review the API documentation in order to verify that your authentication methods are properly configured for the 7.0 API set.

What happens if I do not take action?

As of July 31, 2019, the 6.9 API will no longer function, and your API calls will result in a 404 (Page Not Found) error, causing any integration points you have programmed to use 6.9 API endpoints to fail.

What if there is no matching 7.x API endpoint for the 6.9 API that I currently use?

We are currently undertaking development that will allow us to provide full coverage of 6.9 API endpoints within the version 7 API set. Many of the most popular endpoints are already deployed for 7.0, and we continue to work to develop the remaining endpoints and plan to have them completed in the coming months. Docebo will continue to work toward full 6.9 API coverage and reserves the right to update the End of Life date as necessary based on our development schedule.

Where can I find additional information?

For additional questions, you can open a case ticket with Docebo’s Customer Support via the Communication Center in your platform.

Which 7.0 endpoints match my 6.9 endpoints?

Docebo has kept the endpoints between the two API sets as similar as possible, while at the same time adhering to the REST standard in a better way than before. The main differences between the endpoints for the sets are:

  • Changes of parameters to be embedded in the URL (mandatory POST parameters that are the ID of the item to manipulate have been embedded in the call URL).
  • Change of response format

As a reminder, the old API documentation can be found at the 6.9 URL: [lmsURL]/api/docs#, while the new API documentation can be found at the 7.0 URL: [lmsURL]/api-browser. Please refer to the table below for a list of the old endpoints and the new corresponding endpoints: