# Dropbox

## Overview

Dropbox is a cloud storage and file sharing platform for individuals and teams. Integrate with Dropbox to enable file access, sharing, and document management within Suger.

### Org-Level vs User-Level

> **Org-Level**: Uses OAuth to connect your organization's Dropbox Business account. Provides access to team files and member data.
>
> **User-Level**: Uses OAuth to connect your personal Dropbox account. Provides access to your individual files and folders.

## Create Integration (Org-Level)

### Prerequisites

- Dropbox Business account with admin access
- Permission to authorize third-party apps

### Authenticate by OAuth

1. Navigate to Settings > Integrations
2. Click **Connect Dropbox**
3. You will be redirected to Dropbox to authorize
4. Log in and grant Suger access to your organization's Dropbox
5. Return to Suger — the integration status will show **Created**
6. Click **Verify** to confirm the connection

The org-level integration requires the following Dropbox scopes:

- `files.metadata.read`, `files.content.read`, `files.content.write`
- `sharing.write`, `account_info.read`
- `team_data.member`, `team_info.read`

:::note
The org (team) connection is focused on **browsing and downloading** files within team folders and exposes a smaller, read-oriented set of tools. Writes, sharing, batch operations, and file search are available on the **user-level** connection.
:::

## Create User Integration

1. Click **Connect Now** in the User Integrations section
2. You will be redirected to Dropbox to authorize
3. Grant Suger access to your personal Dropbox files
4. Return to Suger to confirm the connection
5. Click **Verify** to confirm

## Suger AI Tools

When Dropbox is connected, the Suger AI agent can work with your files through Suger's built-in tools. The **user** connection exposes the full set (33 actions); the **org (team)** connection is a smaller, read-oriented subset for browsing and downloading within team folders.

> **Org-level and user-level**: Both are supported; user-level takes precedence when both are connected.

| Capability | What the agent can do | Level |
|------------|-----------------------|-------|
| **File & folder operations** | Upload, download, copy, move, delete, and read metadata (e.g. `upload-file`, `download-file`, `move-file-or-folder`) | User (download & metadata also on org) |
| **Batch operations** | Bulk copy, move, delete, and create with async status polling (e.g. `batch-copy-files-or-folders`, `check-batch-move-files-or-folders`) | User |
| **Sharing** | Manage shared links and shared folders (e.g. `create-shared-link`, `share-folder`) | User |
| **Browse, search & revisions** | List folders, search, and manage revisions and temporary/zip links (e.g. `list-folder`, `search-files-and-folders`, `list-file-revisions`) | User (list & download on org) |
| **Team folders** | List team folders on the Dropbox Business account (e.g. `list-team-folders`) | Org |
| **Account & team admin** | Read the connected account and provision team users on Business (e.g. `get-account`, `create-user`, `delete-user`) | User / Org |

## Edit Integration

Editing is not supported. Delete and recreate.

## Delete Integration

Deleting removes the integration and revokes stored credentials from Suger.

:::warning
To fully revoke access, also disconnect Suger from your Dropbox account settings at [dropbox.com/account/connected_apps](https://www.dropbox.com/account/connected_apps).
:::