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

# Give AI Agents Safe Access to Your Dropbox Files

> Let agents browse, download, upload, and share Dropbox files. Connect with OAuth, choose read or write scopes, and keep tokens out of the agent.

## Overview

Buckle connects AI agents to Dropbox through OAuth. Agents can browse files and folders, download and upload content, and manage sharing. The gateway injects OAuth credentials into requests to the Dropbox API automatically.

## What you will set up

* A Dropbox connection through OAuth, with read access by default and optional write access
* Automatic token injection on requests to the Dropbox API
* Per-agent, per-tool access to files and sharing

## Setup

**1. Open the app**

Open the Buckle dashboard and navigate to **Settings** > **Apps** > **Dropbox**.

**2. Authorize**

Click **Connect Dropbox**. You'll be redirected to Dropbox to authorize Buckle. Review the requested permissions and click **Allow**.

![Buckle connect window for Dropbox on Cloud, showing the Connect to Dropbox button.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/dropbox/buckle-connect-dropbox.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=15b355b26d221e586c2d9129787990ca)

The Dropbox connect window on Buckle Cloud.

Buckle requests read access to account info, file metadata, and file content by default. Write access for uploading, organizing, and sharing is optional.

**3. Verify**

After authorization, you'll be redirected back to the dashboard. The connection will show as **Connected** with your Dropbox email.

## What agents can do

| Area | Description |
| - | - |
| **File metadata (read)** | List files and folders, view names, sizes, and modification dates |
| **File content (read)** | Download and read file content |
| **File content (write)** | Upload new files and update existing content |
| **Organize files (write)** | Move, rename, and delete files and folders |
| **Sharing (read)** | View shared folders and links |
| **Sharing (write)** | Create shared links and share folders with others |

## Use cases

* Document processing agents that read files from Dropbox and extract information
* Backup agents that upload generated reports or exports
* File organization agents that sort and rename files based on content
* Collaboration agents that share files and manage folder permissions

## Self-hosted: use your own Dropbox app

> [!NOTE]
>
> **Skip this section on Buckle Cloud.** It's only for self-hosted Buckle without `DROPBOX_CLIENT_ID` and `DROPBOX_CLIENT_SECRET` set, or if you want your own company name on Dropbox's consent screen.

> [accordion] 1. Create the Dropbox app
>
> Go to the [Dropbox App Console](https://www.dropbox.com/developers/apps) and select **Create app**. Choose **Scoped access** and **Full Dropbox**, name it (for example `Buckle-yourcompany`), and create it.

> [accordion] 2. Add the permissions
>
> Open **Permissions**, tick these, and select **Submit**:
>
> `account_info.read`, `files.metadata.read`, `files.content.read`, `files.content.write`, `sharing.read`, `sharing.write`
>
> ![Dropbox app named Buckle on the Permissions tab, with account\_info.read, files.content.read, and files.content.write ticked.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/dropbox/01-provider-setup.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=56fa3247ddf10738a7121613d3fdbbc2)
>
> The Permissions tab of your Dropbox app, with the file scopes ticked.

> [accordion] 3. Add the redirect URI
>
> In Buckle, open **Settings** > **Apps** > **Dropbox** > **Custom credentials** and copy the **Redirect URI**. In Dropbox, open **Settings**, paste it into **OAuth 2** > **Redirect URIs**, and select **Add**.
>
> ![Buckle Custom credentials card for Dropbox with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/dropbox/buckle-custom-credentials-dropbox.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=698957cd633964564c626c82e32bf6e0)
>
> Copy the Redirect URI from Custom credentials in Buckle.
>
> ![Dropbox app Settings, OAuth 2 section, with https://buckle.example.com/v1/apps/dropbox/callback under Redirect URIs.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/dropbox/02-provider-redirect.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=93df7fa936bf4a4599e8faeb724cd7e1)
>
> The OAuth 2 section of your Dropbox app's Settings tab, with the Buckle Redirect URI.

> [accordion] 4. Connect with your app
>
> On the Dropbox **Settings** tab, copy the **App key** and **App secret**. Paste both into **Settings** > **Apps** > **Dropbox** > **Custom credentials**, select **Save credentials**, then **Connect** and allow access in Dropbox.

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Dropbox.

## FAQ

> [accordion] Can I give an agent read-only access to Dropbox?
>
> Yes. Buckle requests read access by default, and write access is optional. You can also [grant](/docs/guides/agent-access.md) only the read tools to a specific agent.

> [accordion] Does the agent see my Dropbox token?
>
> No. The token stays in Buckle, and the gateway adds it to Dropbox API requests at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Can I require approval before an agent shares or deletes files?
>
> Yes. Set sharing and delete tools to need approval when you grant the connection, or add organization [rules](/docs/guides/rules.md).

> [accordion] How do I reconnect Dropbox?
>
> Open **Settings** > **Apps** > **Dropbox** and connect again. Agents with access use the new connection automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.