API v1 is now deprecated

72769929_thumbnail

Edit 06/23/2017: Deprecation timeline updated to match the one described in our recent blog post

As of today, Dropbox API v1 is deprecated. This includes both the user endpoints (a.k.a. the Core API), and the team endpoints (a.k.a. the Business API). In order to provide our developers with the most up-to-date features and support a single, consistent platform, we’ll be turning off API v1 a year from now, on 6/28/2017.

API v2 is built thoughtfully with a consistent design and adds new endpoints and features. Additionally, we’ve open-sourced our SDK generator, Stone, which revolutionizes how our SDKs are made. Stone also creates an open ecosystem for building and improving our SDKs. Check it out, and see how you can generate Dropbox SDKs for any language you want.

What does this mean for you as a Dropbox API developer?

First, you’ll want to build all new apps on API v2.

Second, you will need to update all of your existing apps to use API v2 as soon as possible. We will be shutting down API v1 in June 2017, so you have a year to transition your app to API v2. Check out our API v1 to v2 migration guide for more details on how to migrate your app.

Finally, you should confirm that you’re aware of the deprecation plan by clicking the button at the top of the screen on the developers site. Beginning September 28, 2016, new users of apps that haven’t acknowledged will see a warning when linking the app for the first time. Beginning March 28, 2017, all users of apps that haven’t acknowledged will be receive warning emails about the upcoming functionality. If you do not want your users to receive direct communication from us, make sure you acknowledge the deprecation on the developers site as soon as possible.

Timeline

  • June 28, 2016: API v1 is deprecated.
  • September 28, 2016: If you haven’t acknowledged the deprecation, new users of your app will see a warning when linking their Dropbox account.
  • June 28, 2017: If you haven’t acknowledged the deprecation, all users who have linked their Dropbox account to your app will receive a warning email.
  • September 28, 2017: API v1 endpoints are turned off.

Thanks for your patience and understanding in the transition to our new API v2. We’re continually working to improve your experience developing for the Dropbox Platform.

Questions? Feedback? Feel free to reach out on our developer forum.