Dropbox API v1 enters deprecation, shutdown set for September 2017

Dropbox has officially deprecated API v1, covering both the Core API (user endpoints) and the Business API (team endpoints). The company plans to turn off all v1 endpoints on September 28, 2017, giving developers roughly 15 months to complete their migration to API v2.

API v2 is designed as a unified platform with consistent conventions across endpoints and adds new capabilities not available in v1. Dropbox has also open-sourced Stone, the SDK generator used to produce its official SDKs, which allows developers to generate Dropbox SDKs for any language. Developers building new applications should target API v2 exclusively from this point forward.

Migration requirements and developer acknowledgment

Existing applications must be updated to API v2 before the shutdown date. Dropbox's API v1-to-v2 migration guide documents the differences between the two versions and outlines the steps required to move an app. Developers are also asked to acknowledge the deprecation plan directly on the Dropbox developers site.

Apps that do not receive this acknowledgment will trigger user-facing warnings for new account links starting September 28, 2016. If the deprecation is still unacknowledged by March 28, 2017, all users who have linked their Dropbox accounts to those apps will receive warning emails about the upcoming loss of functionality.

Deprecation timeline

  • June 28, 2016: API v1 is deprecated.
  • September 28, 2016: New users linking accounts to unacknowledged apps see a warning.
  • March 28, 2017: All users of unacknowledged apps receive warning emails.
  • September 28, 2017: API v1 endpoints are shut down.

Questions and feedback can be directed to the Dropbox developer forum.