list_folders

scope: sharing.read

Return the list of all shared folders the current user has access to.

Basic Parameters

ParameterDescription
ActionsA list of FolderActions corresponding to FolderPermissions that should appear in the response’s SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder.This field is optional.
LimitThe maximum number of results to return per request. The default for this field is 1000.

Advanced Parameters

ParameterDescription
Dropbox API Path RootThe path of the folder in the user’s Dropbox to perform this action from. Can be the path to the user’s home folder, a specific root ID, or a custom namespace.
Dropbox API Select UserSpecify a team member ID to perform this action on behalf of that specific team member.Note: A team access token with the team_data.member scope is required to use this parameter.

Example Output

{
	"value": {
		"cursor": "ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu",
		"entries": [
			{
				"access_inheritance": {
					".tag": "inherit"
				},
				"access_type": {
					".tag": "owner"
				},
				"is_inside_team_folder": false,
				"is_team_folder": false,
				"link_metadata": {
					"audience_options": [
						{
							".tag": "public"
						},
						{
							".tag": "team"
						},
						{
							".tag": "members"
						}
					],
					"current_audience": {
						".tag": "public"
					},
					"link_permissions": [
						{
							"action": {
								".tag": "change_audience"
							},
							"allow": true
						}
					],
					"password_protected": false,
					"url": ""
				},
				"name": "dir",
				"path_lower": "/dir",
				"permissions": [],
				"policy": {
					"acl_update_policy": {
						".tag": "owner"
					},
					"member_policy": {
						".tag": "anyone"
					},
					"resolved_member_policy": {
						".tag": "team"
					},
					"shared_link_policy": {
						".tag": "anyone"
					}
				},
				"preview_url": "https://www.dropbox.com/scl/fo/fir9vjelf",
				"shared_folder_id": "84528192421",
				"time_invited": "2016-01-20T00:00:00Z"
			}
		]
	}
}

Workflow Library Example

List Shared Folders with Dropbox and Send Results Via Email

Preview this Workflow on desktop