> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.dropboxapi.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.dropboxapi.com/_mcp/server. # Paper Migration \[Update: The migration is ongoing, and the legacy Paper API will not be retired until the migration is complete for all users. We’re making continuous advancements and now Create and Update calls are available for .paper files in the filesystem.] ## Paper API to *Paper in the Dropbox API* Migration Guide Starting in September 25 2019, new Paper users will see Paper docs they create as .paper files alongside their Dropbox content **in the filesystem**. This is part of an effort to ensure consistency with where Dropbox and Paper content are stored, and their associated sharing and permissions. As part of this change, any existing /paper/ API endpoints that interact directly with Paper content won’t work for new users whose Paper content is stored alongside their Dropbox content. Instead, the associated /files/ or /sharing/ equivalent API endpoint should be used to interact with a user’s Paper content. Read on for a full list of API endpoints that you should start using to fetch this new .paper file type. A few other things to note: * This change will not affect existing Paper users so you can still use /paper/ endpoints to work with Paper docs created by existing Paper users. * Your app can support both new and existing users as long as you use the appropriate endpoints for a given user. * We’ll eventually retire the Paper API, ensuring all functionalities are transitioned. The following timeline and guide will help you migrate from using /paper/ endpoints to their equivalent /files/ endpoints to work with a user’s Paper docs in the Dropbox file system: | Dates | Planned changes | How you should prepare | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | September 25th, 2019 | • New Paper users will see Paper docs they create as *.paper* files alongside their other Dropbox content. • There won’t be any change to new docs created by existing Paper users. We have been migrating legacy docs to .paper files in phases, with ongoing efforts to ensure all legacy docs are smoothly transitioned. You can check the state of a user (i.e. where their created Paper docs are stored) by calling [/users/features/get\_values](/dropbox-api/api-reference/user-endpoints/users/features-get-values). | • Start using the Dropbox API to fetch Paper docs that are in a user’s filesystem. • If your app already uses the Dropbox API to fetch a user’s files, you’ll start seeing *.paper* files for any Paper docs created by a Dropbox account on or after September 25. Read more about the behavior and limitations of *.paper* files and other online-only files in [this blog post.](https://dropbox.tech/developers/google-docs-sheets-and-slides-with-the-dropbox-api) | | Ongoing | • The Paper API endpoints will be retired once all users have been migrated to use .paper files, which can be accessed by the Dropbox API files endpoints instead. In the meantime, we recommend your app use both the Paper & Dropbox API to interact with your users' Paper docs depending on which version they're on. • The /paper/archive endpoint will not have a Dropbox API equivalent, so you won’t be able to programmatically archive Paper docs. | • Ensure that your app uses the Dropbox API to interact with your users’ Paper docs. | ## Determining where a user’s created Paper docs are stored For a Dropbox account created on or after September 25, 2019, new Paper docs created will be stored in the user’s file system as *.paper* files alongside their other Dropbox content. You can check this using the [/users/features/get\_values](/dropbox-api/api-reference/user-endpoints/users/features-get-values) endpoint and looking for the feature called `paper_as_files`. Note that it is possible for a user to interact with *.paper* files (Paper docs that reside in their filesystem) and legacy Paper docs (the old model). If you want to fetch **all docs that a user has access to**, you’ll need to use both the Paper API and the Dropbox API. ## Endpoint Mapping: Paper API to Dropbox API | Paper API | Dropbox API | | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [/paper/docs/download](/dropbox-api/api-reference/user-endpoints/paper/docs-download) | [/files/export](/dropbox-api/api-reference/user-endpoints/files/export) | | [/paper/docs/folder\_users/list](/dropbox-api/api-reference/user-endpoints/paper/docs-folder-users-list) | [/files/get\_file\_metadata](/dropbox-api/api-reference/user-endpoints/sharing/get-file-metadata) to fetch the doc’s containing folder, then use [/sharing/list\_folder\_members ](/dropbox-api/api-reference/user-endpoints/sharing/list-folder-members)to fetch the folder’s members. | | [/paper/docs/folder\_users/list/continue](/dropbox-api/api-reference/user-endpoints/paper/docs-folder-users-list-continue) | [/sharing/list\_folder\_members/continue](/dropbox-api/api-reference/user-endpoints/sharing/list-folder-members-continue) | | [/paper/docs/get\_folder\_info](/dropbox-api/api-reference/user-endpoints/paper/docs-get-folder-info) | [/files/get\_folder\_metadata](/dropbox-api/api-reference/user-endpoints/sharing/get-folder-metadata) | | [/paper/docs/list](/dropbox-api/api-reference/user-endpoints/paper/docs-list) | [/files/list\_folder ](/dropbox-api/api-reference/user-endpoints/files/list-folder)(start with the root path with recursive set to True, and then do client-side filtering if you just want the Paper docs) | | [/paper/docs/list/continue](/dropbox-api/api-reference/user-endpoints/paper/docs-list-continue) | [/files/list\_folder/continue](/dropbox-api/api-reference/user-endpoints/files/list-folder-continue) | | [/paper/docs/permanently\_delete](/dropbox-api/api-reference/user-endpoints/paper/docs-permanently-delete) | [/files/permanently\_delete](/dropbox-api/api-reference/user-endpoints/files/permanently-delete) | | [/paper/docs/sharing\_policy/get](/dropbox-api/api-reference/user-endpoints/paper/docs-sharing-policy-get) | [/sharing/get\_shared\_link\_metadata](/dropbox-api/api-reference/user-endpoints/sharing/get-shared-link-metadata) | | [/paper/docs/sharing\_policy/set](/dropbox-api/api-reference/user-endpoints/paper/docs-sharing-policy-set) | [/sharing/create\_shared\_link\_with\_settings](/dropbox-api/api-reference/user-endpoints/sharing/create-shared-link-with-settings) | | [/paper/docs/users/add](/dropbox-api/api-reference/user-endpoints/paper/docs-users-add) | [/sharing/add\_file\_member](/dropbox-api/api-reference/user-endpoints/sharing/add-file-member) | | [/paper/docs/users/list](/dropbox-api/api-reference/user-endpoints/paper/docs-users-list) | [/sharing/list\_file\_members](/dropbox-api/api-reference/user-endpoints/sharing/list-file-members) | | [/paper/docs/users/list/continue](/dropbox-api/api-reference/user-endpoints/paper/docs-users-list-continue) | [/sharing/list\_file\_members/continue](/dropbox-api/api-reference/user-endpoints/sharing/list-file-members-continue) | | [/paper/docs/users/remove](/dropbox-api/api-reference/user-endpoints/paper/docs-users-remove) | [/sharing/remove\_file\_member\_2](/dropbox-api/api-reference/user-endpoints/sharing/remove-file-member-2) | | [/paper/folders/create](/dropbox-api/api-reference/user-endpoints/paper/folders-create) | [/files/create\_folder\_v2](/dropbox-api/api-reference/user-endpoints/files/create-folder) | | [/paper/docs/create](/dropbox-api/api-reference/user-endpoints/paper/docs-create) | [/files/paper/create](/dropbox-api/api-reference/user-endpoints/files/paper-create) \[preview] | | [/paper/docs/update](/dropbox-api/api-reference/user-endpoints/paper/docs-update) | [/files/paper/update](/dropbox-api/api-reference/user-endpoints/files/paper-update) \[preview] | ## Functionality that will be retired for new Paper users **The following endpoint does not have a Dropbox API equivalent**. This means that the action will not be available for new Paper users created *on or after* September 25, 2019: * [/paper/docs/archive](/dropbox-api/api-reference/user-endpoints/paper/docs-archive) - Archiving docs will no longer be supported but you can delete docs using the [/files/delete](/dropbox-api/api-reference/user-endpoints/files/delete) endpoint instead. An important difference between deleted docs and archived docs is that deleted docs are scheduled to be permanently removed based on the user’s file retention policy ([see article](https://help.dropbox.com/files-folders/restore-delete/data-retention-policy)) whereas archived docs will indefinitely remain in an archive state and will show up in Paper search results. Paper endpoints will return an error in the following scenarios: 1. If you attempt to create legacy Paper docs for a user whose Paper docs reside in their filesystem (these are usually Dropbox accounts created after September 25, 2019). You’ll see a `permission_denied` or `invalid_request` error. 2. When we fully retire the Paper API. Need support getting your Paper endpoints migrated? [Post a thread](https://www.dropboxforum.com/t5/API-Support-Feedback/bd-p/101000014) in our developer community or [submit a ticket](https://www.dropbox.com/developers/contact) to get help from an API expert.