> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Folder Contents

[list\_folder](https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder)

scope: `files.metadata.read`

Starts returning the contents of a folder. If the result's `ListFolderResult.has_more` field is `true`, call `list_folder/continue` with the returned `ListFolderResult.cursor` to retrieve more entries.
If you're using `ListFolderArg.recursive` set to `true` to keep a local cache of the contents of a Dropbox account, iterate through each entry in order and process them as follows to keep your local state in sync:
For each `FileMetadata`, store the new entry at the given path in your local state. If the required parent folders don't exist yet, create them. If there's already something else at the given path, replace it and remove all its children.
For each `FolderMetadata`, store the new entry at the given path in your local state. If the required parent folders don't exist yet, create them. If there's already something else at the given path, replace it but leave the children as they are. Check the new entry's `FolderSharingInfo.read_only` and set all its children's read-only statuses to match.
For each `DeletedMetadata`, if your local state has something at the given path, remove it and all its children. If there's nothing at the given path, ignore this entry.
Note: `auth.RateLimitError` may be returned if multiple `list_folder` or `list_folder/continue` calls with same parameters are made simultaneously by same API app for same user. If your app implements retry logic, please hold off the retry until the previous request finishes.

## Basic Parameters

<div className="integrations-table">
  | Parameter       | Description                                                                                                                                                                       |
  | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Include Deleted | If true, the results will include entries for files and folders that used to exist but were deleted. The default for this field is False.                                         |
  | Path            | A unique identifier for the file.                                                                                                                                                 |
  | Recursive       | If true, the list folder operation will be applied recursively to all sub-folders and the response will contain contents of all sub-folders. The default for this field is False. |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                           | Description                                                                                                                                                                                           |
  | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Dropbox API Path Root               | The 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 Admin            | Specify a team administrator ID to perform this action with administrator privileges.<br /><br />**Note**: A team access token with the `team_data.member` scope is required to use this parameter.   |
  | Dropbox API Select User             | Specify a team member ID to perform this action on behalf of that specific team member.<br /><br />**Note**: A team access token with the `team_data.member` scope is required to use this parameter. |
  | Include Has Explicit Shared Members | If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False.                                             |
  | Include Media Info                  | When checked, include additional media information for photos and videos.                                                                                                                             |
  | Include Mounted Folders             | If true, the results will include entries under mounted folders which includes app folder, shared folder and team folder. The default for this field is True.                                         |
  | Include Non Downloadable Files      | If true, include files that are not downloadable, i.e. Google Docs. The default for this field is True.                                                                                               |
</div>

## Example Output

```json theme={"dark"}
{
	"entries": [
		{
			".tag": "<string>",
			"name": "<string>",
			"path_lower": "<string>",
			"path_display": "<string>",
			"id": "<string>",
			"shared_folder_id": "<string>",
			"sharing_info": {
				"read_only": false,
				"shared_folder_id": "<string>",
				"traverse_only": false,
				"no_access": false
			}
		}
	],
	"cursor": "<string>",
	"has_more": true
}
```

## Workflow Library Example

[Get Folder Contents with Dropbox and Send Results Via Email](https://library.blinkops.com/workflows/get-folder-contents-with-dropbox-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/get-folder-contents-with-dropbox-and-send-results-via-email/canvas" />
</div>