---
title: "List user's Dropbox files"
method: GET
path: "/api/v1/dropbox/files"
---

# List user's Dropbox files

`GET /api/v1/dropbox/files`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/dropbox/files`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

AUTHORITATIVE: Returns LIVE list of files from the authenticated user's Dropbox. Use when user asks 'show my Dropbox files', 'what's in my Dropbox'. Supports pagination and folder navigation. **NOTE:** If not authenticated with Dropbox, user must visit /oauth/dropbox/authorize first.

## Query parameters

- `folder_path` string
- `max_results` integer
- `cursor` string

## Response `200`

LIVE file list from user's Dropbox

- DropboxFilesResponse
  - `user` string
  - `files` DropboxFile[]
    - `id` string: Dropbox file ID
    - `name` string: File name
    - `path_lower` string: Full path in lowercase
    - `path_display` string: Full path with original casing
    - `size` integer: File size in bytes
    - `client_modified` string, date-time: Client-side modification timestamp
    - `server_modified` string, date-time: Server-side modification timestamp
    - `is_downloadable` boolean: Whether the file can be downloaded
    - `content_hash` string: Content hash for change detection
  - `count` integer: Number of files in this page
  - `cursor` string: Cursor to get next page (null if no more pages)
  - `hasMore` boolean: Whether more files are available

## Other responses

- `401`: Authentication required
- `500`: Internal server error
- `503`: Dropbox not authenticated. User must authenticate at /oauth/dropbox/authorize

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)