# Dropbox

Manage Dropbox files: upload, download, move, search, and shared links. Exposes **24 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `dropbox_account_get` | Get authenticated user's account info - POST /users/get_current_account. |
| `dropbox_space_usage_get` | Get space usage info - POST /users/get_space_usage. |
| `dropbox_files_list` | List files/folders in a directory - POST /files/list_folder. |
| `dropbox_file_get_metadata` | Get metadata for a file or folder - POST /files/get_metadata. |
| `dropbox_file_download` | Download a file - POST /files/download (content endpoint). |
| `dropbox_file_upload` | Upload or create a file - POST /files/upload (content endpoint). |
| `dropbox_file_delete` | Delete a file or folder - POST /files/delete_v2. |
| `dropbox_file_move` | Move (rename) a file or folder - POST /files/move_v2. |
| `dropbox_file_copy` | Copy a file - POST /files/copy_v2. |
| `dropbox_file_search` | Search for files/folders - POST /files/search_v2. |
| `dropbox_file_revisions_list` | List revisions of a file - POST /files/list_revisions. |
| `dropbox_folder_create` | Create a new folder - POST /files/create_folder_v2. |
| `dropbox_sharing_link_create` | Create a sharing link for a file/folder - POST /sharing/create_shared_link_with_settings. |
| `dropbox_sharing_links_list` | List sharing links - POST /sharing/list_shared_links. |
| `dropbox_sharing_link_get` | Get sharing link metadata - POST /sharing/get_shared_link_metadata. |
| `dropbox_sharing_link_delete` | Revoke a sharing link - POST /sharing/revoke_shared_link. |
| `dropbox_sharing_folders_list` | List shared folders - POST /sharing/list_folders. |
| `dropbox_sharing_folder_get` | Get shared folder metadata - POST /sharing/get_folder_metadata. |
| `dropbox_sharing_folder_update` | Update shared folder settings - POST /sharing/update_folder_policy. |
| `dropbox_files_copy_batch` | Copy multiple files/folders - POST /files/copy_batch_v2. |
| `dropbox_files_move_batch` | Move multiple files/folders - POST /files/move_batch_v2. |
| `dropbox_files_delete_batch` | Delete multiple files/folders - POST /files/delete_batch. |
| `dropbox_team_members_list` | List team members (team account only) - POST /team/members/list. |
| `dropbox_team_member_info` | Get team member info (team account only) - POST /team/members/get_info. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Dropbox to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Dropbox API documentation](https://www.dropbox.com/developers/documentation)