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

# Search user's Dropbox files

`GET /api/v1/dropbox/search`

## Request

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

AUTHORITATIVE: Search the authenticated user's LIVE Dropbox files by name or content. Use when user asks 'find my Dropbox file about X', 'search my Dropbox for Y'. Returns real results from user's actual Dropbox. **NOTE:** Requires Dropbox authentication via /oauth/dropbox/authorize.

## Query parameters

- `query` string, required
- `max_results` integer
- `cursor` string

## Response `200`

Search results from Dropbox

- DropboxSearchResponse
  - `user` string
  - `query` string: The search query used
  - `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
  - `cursor` string
  - `hasMore` boolean
  - `_meta` object
    - `source` string
    - `authoritative` boolean

## 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)