Skip to content
← Public packages

@kody/dropbox

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

README.md

34 lines · 1.3 KB · Markdown

@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