We’re Still Here to Help (Even Over the Holidays!) - find out more here.
Forum Discussion
23W
7 years agoHelpful | Level 5
How can I list content of sharded folder that has not mounted yet?
How can I list content of sharded folder that has not been mounted yet?
- 7 years ago
The Dropbox API functionality for listing folders is generally only meant for mounted content, but you can technically list the contents of an unmounted folder by calling /2/files/list_folder with the 'preview_url' (e.g., from the shared folder metadata) as the 'shared_link.url' parameter, like:
curl -X POST https://api.dropboxapi.com/2/files/list_folder \ --header "Authorization: Bearer <ACCESS_TOKEN>" \ --header "Content-Type: application/json" \ --data "{\"path\": \"\", \"shared_link\": {\"url\": \"<PREVIEW_URL>\"}}"
Greg-DB
Dropbox Community Moderator
7 years agoThe Dropbox API functionality for listing folders is generally only meant for mounted content, but you can technically list the contents of an unmounted folder by calling /2/files/list_folder with the 'preview_url' (e.g., from the shared folder metadata) as the 'shared_link.url' parameter, like:
curl -X POST https://api.dropboxapi.com/2/files/list_folder \
--header "Authorization: Bearer <ACCESS_TOKEN>" \
--header "Content-Type: application/json" \
--data "{\"path\": \"\", \"shared_link\": {\"url\": \"<PREVIEW_URL>\"}}"
- 23W7 years agoHelpful | Level 5
Greg-DB, thank you. It really works.
But next question appears: if such folder contains sub-folders, how to browse them?
"/2/files/lits_folder" returns list of sub-folders with theirs Ids. Direct attempt to use one of them with "/2/files/lits_folder" returns error "path not found". If i try to use "/2/sharing/get_folder_metadata" with sub-folder's id, i receive error "invalid id".
All those Ids have prefix like "id:_XXXXXX".- Greg-DB7 years ago
Dropbox Community Moderator
The "id" values for the listed items, starting file "id:", is the "file ID", which is different than a "shared folder ID", so you can't use that for /2/sharing/get_folder_metadata,
You can use the "path" parameter to list a subfolder when accessing a shared link via /2/files/list_folder though. That would look like:
curl -X POST https://api.dropboxapi.com/2/files/list_folder \ --header "Authorization: Bearer <ACCESS_TOKEN>" \ --header "Content-Type: application/json" \ --data "{\"path\": \"/subfoldername\", \"shared_link\": {\"url\": \"<PREVIEW_URL>\"}}"- 23W7 years agoHelpful | Level 5
Greg-DB
Thank you. So if I for example have following structure in shared folder:- Shared Folder
- Sub Folder 1
- Sub Folder 2
- file 1 in Sub Folder 1
- file 2 in Sub Folder 1
- file 1 in Shared Foder
- Sub Folder 1
And I want to browse contenten of "Sub Folder 1", I have to use "/2/files/list_folder" endpoint with "shared_link" of "Shared Folder" and "path" equal to "/Sub Folder 1".
If I want to do the same but for "Sub Folder 2", "path" parameter should be "/Sub Folder1/Sub Folder 2". Am I right?
It is not convenient way as for me because in my application it's possible that I know only "id" of "Sub Folder 2" and "shared id" of "Shared Folder", so I don't know exact relative path from "Shared Folder" to "Sub Folder 2". :(
From other side, I've found that I can use "namespace" of "Shared Folder" to browse it content and use "id"s of files and folder directly as "path" parameter, without building "shared_link" url from PreviewUrl of "Shared Folder". As soon as I'm using your C# SDK, I build client via following method:
client = client.WithPathRoot(new Dropbox.Api.Common.PathRoot.NamespaceId(sharedFolder.SharedFolderId));
And looks like it works.
So can I use this method to work with Shared Folders that are NOT mounted to the user's storage? "Work" in this case means browse, upload, download, delete files, create sub folders and so on.As I understand from documentation this method is suitable for Team Folders also, correct?
- Shared Folder
About Dropbox API Support & Feedback
Find help with the Dropbox API from other developers.
The Dropbox Community team is active from Monday to Friday. We try to respond to you as soon as we can, usually within 2 hours.
If you need more help you can view your support options (expected response time for an email or ticket is 24 hours), or contact us on X, Facebook or Instagram.
For more info on available support options for your Dropbox plan, see this article.
If you found the answer to your question in this Community thread, please 'like' the post to say thanks and to let us know it was useful!