@apicity/dropbox

Dropbox HTTP API provider for users, files, content upload/download, and sharing endpoints.

Runtime dependencies:

• zod@^4.4.3 — request schemas attached to Dropbox endpoint methods as .schema

Installation

npm install @apicity/dropbox
# or
pnpm add @apicity/dropbox

Quick Start

import { createDropbox } from "@apicity/dropbox";

const dropbox = createDropbox({ oauthToken: process.env.DROPBOX_OAUTH_TOKEN! });

If oauthToken is omitted, the provider reads DROPBOX_OAUTH_TOKEN at request time. Tokens are only sent in the Authorization: Bearer ... header.

API Reference

13 endpoints across 4 groups. Each method mirrors an upstream URL path.

check

POST https://api.dropboxapi.com/2/check/user

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.check.user({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

files

POST https://api.dropboxapi.com/2/files/copy_v2

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.copyV2({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/files/create_folder_v2

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.createFolderV2({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/files/delete_v2

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.deleteV2({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://content.dropboxapi.com/2/files/download

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.download({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/files/get_metadata

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.getMetadata({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/files/list_folder

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.listFolder({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/files/list_folder/continue

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.listFolderContinue({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/files/move_v2

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.moveV2({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://content.dropboxapi.com/2/files/upload

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.files.upload({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

sharing

POST https://api.dropboxapi.com/2/sharing/create_shared_link_with_settings

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.sharing.createSharedLinkWithSettings({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

POST https://api.dropboxapi.com/2/sharing/list_shared_links

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.sharing.listSharedLinks({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

users

POST https://api.dropboxapi.com/2/users/get_current_account

Cost tier: cheap

Upstream docs ↗

const res = await dropbox.users.getCurrentAccount({ /* ... */ });

Source: packages/provider/dropbox/src/dropbox.ts

Part of the apicity monorepo.

License

MIT — see LICENSE.