> This page is for Agent Filesystem.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.dropboxapi.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.dropboxapi.com/_mcp/server.

# Application Setup

Create an application with the permissions needed to manage users, agents, and
files. The Developer Console configures the application for you.

> **Warning**
>
> Agent Filesystem is in Private Preview and is subject to change. If the
> Credentials page or **Agent Filesystem** option is unavailable, contact your
> Dropbox representative to request access.

## Create your app

1. Sign in to the [Developer Console Credentials page](https://www.dropbox.com/developers/console/credentials)
   with the Dropbox account that will own the application.
2. Click **Create credential**.
3. Select **Agent Filesystem** in the **Product** field.
4. Enter a unique **Application name**.
5. Click **Create application**.
6. Copy the **App key** and **App secret** to configure your backend application.
   Click **Show secret** to reveal the secret.

![Credentials page with the Create credential button](/_fern-img/33c540db101aa372a04d95eddb9215c67053d98f665caeeea32f925b89d6aa4a.webp)![Create a credential dialog with Agent Filesystem selected and a unique application name](/_fern-img/500d0c4f8dd96a9c9007d28bf2b2b105d78393f6ad6e2f9e5dd4ef94ef91d35f.webp)

If prompted, verify your email and complete developer onboarding to accept the
Dropbox API terms. Then return to Credentials to create the application.

The new application appears in the Credentials list with **Agent Filesystem**
as its product. It is ready to create managed users and agent workspaces. It
starts in development status with a limit of **500 users**.

## Store your app key and secret

Store the app key and secret in your backend secret store.

Click **Open application** to view its settings. You can return to Credentials
and open the application to retrieve its credentials later.

Keep the app secret in your trusted backend. Do not include it in browser or
agent-runtime code.

> **Note**
>
> If creation fails without a clear result, check Credentials or
> [Apps](https://www.dropbox.com/developers/console/apps) before trying again.
> The application may already have been created.

## Choose a user flow

### Managed users

Use the app key and secret to create API-only managed users and mint their user
access tokens. The application is already configured for this flow. Your end
users do not need Dropbox accounts or a Dropbox OAuth sign-in.

Follow the [managed user flow](/agentfs/docs/concepts/authentication#managed-user-flow),
then continue to the [Quickstart](/agentfs/docs/get-started/quickstart) or
[Mount guide](/agentfs/docs/concepts/mount#managed-user).

### Existing Dropbox users

To use files in an existing Dropbox account, connect that account through the
[OAuth flow](/dropbox-api/docs/oauth).

For testing with your own account, you can generate a user access token in the
application settings:

1. Find the **OAuth 2** section.
2. Under **Generated access token**, click **Generate**.
3. Copy the token and store it securely in your backend environment.

This test token is valid for **four hours**. Generate a new one when it expires.
Then continue to the [Quickstart](/agentfs/docs/get-started/quickstart) to create
an agent and write your first file.