Forum Discussion

Explorer | Level 3

8 years ago

Solved

How to list the contents of a team folder?

I am using dropbox business account and API v2.0. I have team folder with many subfolders and files in it. When I call the api /team_folder/list I get the name of the team folder. But how do I get list the contents (both files and folders) of a teamfolder? I couldnt find any related api calls in the team section in the documentation - https://www.dropbox.com/developers/documentation/http/teams#team-team_folder-list.

Please advice.

Also, please let me know if there is any PHP sdk available for Business API. Currently I am using HTTP api requests.

Thanks.

API

Greg-DB
8 years ago
In order to list the contents of a folder, such as a team folder, you should use /2/files/list_folder[/continue]:

https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder
https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-continue

Note that this is a user endpoint, so if you have a Business API app, you'd need to have the "team member file access" permission and use the "member file access" feature:

https://www.dropbox.com/developers/documentation/http/teams#teams-member-file-access

We don't have an official PHP SDK for Dropbox API v2, but you can use a third party library:

https://www.dropbox.com/developers/documentation/communitysdks

Or, you can call the HTTPS endpoints themselves, as you have been:

https://www.dropbox.com/developers/documentation/http/documentation

6 Replies

Mark
Super User II
8 years ago
*moves to API forum*
Greg-DB
Dropbox Community Moderator
8 years ago
In order to list the contents of a folder, such as a team folder, you should use /2/files/list_folder[/continue]:

https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder
https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder-continue

Note that this is a user endpoint, so if you have a Business API app, you'd need to have the "team member file access" permission and use the "member file access" feature:

https://www.dropbox.com/developers/documentation/http/teams#teams-member-file-access

We don't have an official PHP SDK for Dropbox API v2, but you can use a third party library:

https://www.dropbox.com/developers/documentation/communitysdks

Or, you can call the HTTPS endpoints themselves, as you have been:

https://www.dropbox.com/developers/documentation/http/documentation
hsin
Explorer | Level 4
8 years ago
According to this article: https://www.dropbox.com/help/business/team-folders

I believe that there're two kinds of Dropbox Business Account:

A: the Dropbox Business account created a long time ago.

B: the Dropbox Business account created recently. => with Team Space

The /2/files/list_folder lists all the files include team folders of A.

But the /2/files/list_folder lists only the files in the purple folder (private folder) of B.

Is there any way to list team folders and their contents of B's Team Space?

Thank you!
Greg-DB
Dropbox Community Moderator
8 years ago
hsin Yes, that's correct. For the newer type B, please refer to the namespace guide, which covers how to access the team space:

https://www.dropbox.com/developers/reference/namespace-guide
msullybos
Explorer | Level 3
4 years ago
For files/list_folders, can you use the team_folder_id in place of the path?
Thanks
Greg-DB
Dropbox Community Moderator
4 years ago
msullybos Yes, the /2/files/list_folder endpoint supports namespace ID paths in the 'path' parameter, so you can use the team_folder_id for a team folder as the 'path' value, like "ns:123456789", where 123456789 is the team_folder_id. (For information on how to interact with a team space though, refer to the Team Files Guide.)