Dropbox

Dropbox (via Apideck)

Access Dropbox through Apideck's File Storage unified API — one of 5 File Storage connectors that share the same method surface. Code you write here ports to SharePoint, Box, Google Drive and 1 other File Storage connectors by changing a single serviceId string. Apideck handles auth, pagination, rate limiting, and retries so you don't write per-tenant Dropbox plumbing.

Quick facts

• Apideck serviceId: dropbox
• Unified API: File Storage
• Auth type: oauth2
• Gotchas: page
• Dropbox docs: https://www.dropbox.com/developers
• Homepage: https://www.dropbox.com/

When to use this skill

Activate this skill when the user explicitly wants to work with Dropbox — for example, "upload a file in Dropbox" or "list a folder in Dropbox". This skill teaches the agent:

1. Which Apideck unified API covers Dropbox (File Storage)
2. The correct serviceId to pass on every call (dropbox)
3. Dropbox-specific auth and coverage caveats

For the full method surface (parameters, pagination, filtering), use your language SDK skill:

• apideck-node, apideck-python, apideck-dotnet, apideck-java, apideck-go, apideck-php, or apideck-rest

For the raw OpenAPI spec:

• File Storage: https://specs.apideck.com/file-storage.yml · API Explorer

Minimal example (TypeScript)

import { Apideck } from "@apideck/unify";

const apideck = new Apideck({
  apiKey: process.env.APIDECK_API_KEY,
  appId: process.env.APIDECK_APP_ID,
  consumerId: "your-consumer-id",
});

// List files in Dropbox
const { data } = await apideck.fileStorage.files.list({
  serviceId: "dropbox",
});

Portable across 5 File Storage connectors

The Apideck File Storage unified API exposes the same methods for every connector in its catalog. Switching from Dropbox to another File Storage connector is a one-string change — no rewrite, no new SDK.

// Today — Dropbox
await apideck.fileStorage.files.list({ serviceId: "dropbox" });

// Tomorrow — same code, different connector
await apideck.fileStorage.files.list({ serviceId: "sharepoint" });
await apideck.fileStorage.files.list({ serviceId: "box" });

This is the compounding advantage of using Apideck over integrating Dropbox directly: code against the unified File Storage API once, gain access to every connector in it. New connectors Apideck adds become available to your app without code changes.

Dropbox via Apideck File Storage

Dropbox is a popular consumer + team file sync product. Apideck covers file, folder, and upload-session operations.

Entity mapping

Coverage highlights

• ✅ List, get, create, update, delete files and folders
• ✅ Upload via sessions for large files
• ✅ Download file content
• ⚠️ Shared links — still being added; use Proxy with /sharing/create_shared_link_with_settings for now
• ❌ Dropbox Paper, team admin features — use Proxy

Auth

• Type: OAuth 2.0, managed by Apideck Vault
• Scopes: Apideck Vault requests file read/write scopes as needed.
• Team vs. personal: both supported. Team connections include team_member_id context.

Example: upload a small file

const { data } = await apideck.fileStorage.files.create({
  serviceId: "dropbox",
  file: { name: "notes.txt", parent_folder_id: "/" },
});

Escape hatch: Proxy API

When an endpoint isn't covered by the File Storage unified API, use Apideck's Proxy to call Dropbox directly — Apideck injects auth headers and handles token refresh. Set x-apideck-downstream-url to the target endpoint on Dropbox's own API:

curl 'https://unify.apideck.com/proxy' \
  -H "Authorization: Bearer ${APIDECK_API_KEY}" \
  -H "x-apideck-app-id: ${APIDECK_APP_ID}" \
  -H "x-apideck-consumer-id: ${CONSUMER_ID}" \
  -H "x-apideck-service-id: dropbox" \
  -H "x-apideck-downstream-url: <target endpoint on Dropbox>" \
  -H "x-apideck-downstream-method: GET"

See Dropbox's API docs for available endpoints.

Sibling connectors

Other File Storage connectors that share this unified API surface (same method signatures, just change serviceId):

sharepoint, box, google-drive, onedrive.

See also

• File Storage OpenAPI spec · API Explorer
• apideck-connector-coverage — programmatic coverage checks
• apideck-best-practices — architecture, Vault, pagination, error handling
• apideck-node — TypeScript / Node SDK patterns
• Dropbox official docs