Skip to content
← Public packages

@kody/dropbox

Reusable Dropbox OAuth helpers for account, metadata, search, file transfer, sharing, and generic API requests.

FollowFork
Featured

OtherTopics: dropbox, files, storage, oauth, sharing, search

Version
1.1.0
License
MIT
Published
November 9, 2026
Pinned commit
238ba35
Rating
No ratings yet
Forks
0
Adaptation effort
—

README

Agent docs

@kody/dropbox

Intent

Provide reusable, account-agnostic Dropbox helpers for Kody agents through the standard saved dropbox OAuth integration. Cover common account, metadata, search, transfer, deletion, and sharing workflows while retaining a generic escape hatch for the rest of the Dropbox API.

What it does

  • Inspect the connected Dropbox account or storage usage
  • List folders, read metadata, and search for files
  • Download or upload file content
  • Delete files or create shared links with explicit confirmation
  • Call less-common Dropbox RPC and content endpoints through ./request

Mutating helpers require confirm: true and support dryRun: true. Paths begin with /; use an empty string for the account root.

Prerequisites / setup

  1. Connect a Dropbox OAuth integration named dropbox at https://kody.codes/connect/oauth?provider=dropbox.
  2. Grant the scopes your workflows need. Common scopes: account_info.read, files.metadata.read, files.metadata.write, files.content.read, files.content.write, sharing.read, sharing.write.
  3. Agents: see AGENTS.md for import paths, smoke, and dryRun.

Done when

  • The dropbox OAuth integration is connected
  • Smoke test returns { ok: true } without account PII
  • Mutations refuse without confirm: true; dryRun: true never calls Dropbox

Reliable large files

The included local-file uploader uses this organization’s Dropbox OAuth mapping, private atomic checkpoints, bounded 16 MiB chunks, and Dropbox content-hash verification. It requires Kody CLI 3.33.1+; no personal account alias or new credential is needed. Uncertain completion fails closed rather than silently duplicating a file.

Report this listing

Log in to report this listing.