Paper API - how to query "old" paper docs with the "new" 2020 API

Question

Hello, we're building an integration of Dropbox Paper to our service - many dropbox paper users have requested it.
Seems that Dropbox Paper itself is being migrated from its own place of paper.dropbox.com to having `.paper` files inside Dropbox itself. That itself is all cool but I'm having trouble figuring which API to use to support our current users without having to build two different APIs - since the `/paper` endpoints are going to be removed in a month.

Here are some functionality I'm looking to support:
- when a user connects Dropbox with OAuth2, we need to be able to query all their Dropbox Paper. How do we do that for legacy users who have been around before Sep 25 2019, without using the deprecated endpoints. Where would the .paper docs be migrated to, i.e. under which path?
-  How do I query for the .paper file contents? We need those to help our users with full text search functionality. The migration guide suggests /files/export but that endpoint seems deprecated.

Best regards, I worked at Dropbox at 2012, and have seen some of the early versions of what came to be Dropbox Paper - great to see it has gone a long way!

Greg-DB · Accepted Answer

when a user connects Dropbox with OAuth2, we need to be able to query all their Dropbox Paper. How do we do that for legacy users who have been around before Sep 25 2019, without using the deprecated endpoints.

Right now, the only way to programmatically access Paper docs for users that haven't been migrated (i.e., not .paper files), is to use the old endpoints. While they're marked deprecated, they are still available to use for this.

Where would the .paper docs be migrated to, i.e. under which path?

I don't have specifics to share like this right now, such as the exact path(s) for migrated docs. Note that users can move around .paper files anyway though, so I don't recommend relying on them being under a particular path. You'll want to be able to handle them anywhere, e.g., by listing them using /2/files/list_folder[/continue], like you would with normal files.

How do I query for the .paper file contents? We need those to help our users with full text search functionality. The migration guide suggests /files/export but that endpoint seems deprecated.

To retrieve the content of Paper docs from .paper files, you should use /2/files/export. That's not marked deprecated though. Did you see it set as deprecated somewhere? Please let me know if so, so we can fix that up. Thanks!