> 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.

# DBX Agent Filesystem

Agent Filesystem gives users and agents persistent file storage in your
product. Connect an existing Dropbox user or create an API-only managed user,
then give each agent access to selected files and folders. Users and agents
call Dropbox file APIs with different credentials and access limits.

> **Beta access**
>
> Agent Filesystem is in Beta and is subject to change. Contact [agentfs@dropbox.com](mailto:agentfs@dropbox.com) to request access.

## DBX CLI Demo

This demo shows how to use the `dbx` CLI to create an agent workspace for a
Dropbox user, mount it as a local directory, and use it with a coding agent.

## How it works

Your app connects or creates a user, then creates an agent for that user and
sets the agent's workspace rules.

```mermaid
flowchart LR
    App["App"] -->|"connects or creates"| User["User"]
    User -->|"owns"| Agent["Agent"]
    Agent -->|"has"| Workspace["Workspace rules"]
    Workspace -->|"limits access to"| Files["Files and folders"]
```

The user's file permissions set the maximum access. Token scopes and workspace
rules can reduce that access. They cannot give an agent access that the user
does not have.

## Start building

#### [Quickstart](/agentfs/docs/get-started/quickstart)

Create your app, connect a user, and mount an agent workspace.

#### [Sample Apps](/agentfs/docs/get-started/sample-apps)

Explore reference apps built on Agent Filesystem.

#### [Identity](/agentfs/docs/concepts/identity)

Learn how apps, users, agents, and workspaces relate.

#### [Authentication](/agentfs/docs/concepts/authentication)

Choose credentials and store tokens safely.

#### [Workspaces](/agentfs/docs/concepts/workspaces)

Set which files and folders each agent can read or write.

#### [File Operations](/agentfs/docs/concepts/file-operations)

Find the Dropbox file APIs and scopes available to users and agents.

#### [Mount](/agentfs/docs/concepts/mount)

Mount a workspace as a local directory.

#### [Recovery](/agentfs/docs/concepts/recovery)

Inspect an agent's changes and undo unwanted writes.

#### [API Reference](/agentfs/api-reference/overview)

Review endpoint paths, requests, responses, and credentials.