Source
Export, API & self-hosting — found from sitemap — Dropbox
Checked for Dropbox on 1 Nov 2026
- Page
- https://www.dropbox.com/developers/reference/migration-guide
- Checked
- 1 Nov 2026, 08:59 UTC
- How we may use it
- Public page, crawling permitted
Technical details
- type
- page
- http status
- 200
- content hash
- sha256:e2fb4a33a9d5cc6e746042d8855069672256c955e68a1f220e5e9a038b7b41c6
- permission
- robots_ok
- screenshot
- Screenshot on file (internal exhibit, not published)
Cited by
Facts read from this source
-
API v2 oauth Report an error
“Note: API v2 only uses OAuth 2. The new endpoints do not have the /2 prefix, but rather, just begin with /oauth2.”
-
API v1 retired Report an error
“API v1 is retired as of September 2017. Any API v1 calls will fail with a 400 error with the body:”
-
API file ids Report an error
“Tip: Did you know that API v2 now has file IDs? With v2, you can now use a file ID instead of path when working with files, which means that you won't lose track of a file even if a user moves or renames it.”
-
API content search Report an error
“Tip: Did you know that for Dropbox Business accounts, API v2 now supports file-content search as well as file-name search? Upgrade your Business app to v2 to take advantage of this new functionality.”
-
API sharing invites Report an error
“Tip: Did you know that API v2 has tons of new sharing functionality, including the ability to invite users to shared folders? Learn more.”
-
API linked apps list Report an error
“Tip: Did you know that API v2 for Business teams now supports listing all the apps that members have linked to their Dropbox accounts? Check out the /2/team/linked_apps/ endpoints to learn more.”
-
API admin permission levels Report an error
“Tip: There are now four levels of permission for team members. See the full documentation for details.”
-
API suspend users Report an error
“Tip: You can now also suspend users, which preserves their data but blocks them from accessing their account. See /2/team/members/suspend and /2/team/members/unsuspend for more details.”
-
API members add batch Report an error
“Note: The v2 version can add up to 20 members at a time. If it returns async_job_id, use /2/team/members/add/job_status/get to check the status of the asynchronous additions of each team member.”
-
API error handling Report an error
“In v2, all endpoint-specific errors are returned with a 409 status code; the details of the error are in the response body.”
-
API http methods Report an error
“Note that all v2 endpoints use POST, and that the parameters generally sent as JSON objects in the request body.”
-
API date format Report an error
“v2: All dates are strings in the ISO 8601 "combined date and time representation" format. For example, "2007-04-05T14:30".”
-
API cursor compatibility Report an error
“Tip: You can use a cursor returned from v1's /1/delta in calls to v2's /files/list_folder/continue.”
-
API file type permission removed Report an error
“If your app has File Type permission, you will need to re-authenticate your users with a new permission, or "access type." File Type permission is not supported in API v2.”
-
API dropins no migration Report an error
“Chooser and Saver apps do not need to be migrated to v2; they will continue working after v1 is retired.”
-
API locale header Report an error
“v2: All endpoints can take the new "Dropbox-Locale: <locale>" header”
-
API async pattern Report an error
“Many v2 team endpoints now trigger asynchronous processes on the server (e.g. /team/members/add). When that is the case, the API call will return an async_job_id.”
-
API team reports Report an error
“/1/team/reports/get_storage /2/team/reports/get_storage”
-
API audit log Report an error
“/1/team/log/get_events /2/team_log/get_events”
-
API temporary link Report an error
“/1/media /2/files/get_temporary_link”
-
API list revisions Report an error
“/1/revisions /2/files/list_revisions”
-
API permanent delete Report an error
“/1/fileops/permanently_delete /2/files/permanently_delete”
-
API token migration Report an error
“Use the /2/auth/token/from_oauth1 endpoint to migrate an OAuth 1 token to an OAuth 2 token.”
-
API select user header Report an error
“For apps with Team Member File Access permissions, the custom HTTP header has changed. For v1 calls, you used X-Dropbox-Perform-As-Team-Member. For v2 calls, you will use Dropbox-API-Select-User.”
-
API objective c sdk Report an error
“Note: We also have an official API v2 SDK for Objective-C.”
-
API delete user message Report an error
“If it makes sense in your app's user experience, and if it's set in the error object, you can utilize the user_message value as a human-readable error message.”
Scores citing this record
- The Agency Producer Administration, audit & governance
- The Agency Producer Export, API & self-hosting
- The Architecture Practice Partner Export, API & self-hosting
- The IT Lead Administration, audit & governance
- The IT Lead Export, API & self-hosting
- The Skeptic Administration, audit & governance
- The Skeptic Export, API & self-hosting