@kody/dropbox

@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.

When To Use

• 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 a generic request helper

Required Setup

Connect a Dropbox OAuth integration named dropbox at:

https://heykody.dev/connect/oauth?provider=dropbox

The integration needs the scopes required by the operations you call. Common scopes include account_info.read, files.metadata.read, files.metadata.write, files.content.read, files.content.write, sharing.read, and sharing.write.

Safety

Mutating helpers require confirm: true. Pass dryRun: true to inspect a request without sending it. The generic request helper recognizes documented read-only endpoints; all other endpoints require confirmation.

Exports

• kody:@kody/dropbox — package overview and setup guidance
• kody:@kody/dropbox/smoke-test — verify OAuth without returning account data
• kody:@kody/dropbox/get-current-account — current account details
• kody:@kody/dropbox/get-space-usage — current storage usage
• kody:@kody/dropbox/list-folder — list a folder, with optional pagination
• kody:@kody/dropbox/get-metadata — metadata for a file or folder
• kody:@kody/dropbox/search — search file and folder names
• kody:@kody/dropbox/download — download bytes as base64
• kody:@kody/dropbox/upload — upload text or base64 bytes
• kody:@kody/dropbox/delete — delete a file or folder
• kody:@kody/dropbox/create-shared-link — create a shared link
• kody:@kody/dropbox/request — generic authenticated RPC, upload, or download request

Examples

import listFolder from 'kody:@kody/dropbox/list-folder'

export default async function main() {
	return await listFolder({ path: '' })
}

import upload from 'kody:@kody/dropbox/upload'

export default async function main() {
	return await upload({
		path: '/notes/hello.txt',
		text: 'Hello from Kody',
		mode: 'overwrite',
		confirm: true,
	})
}

Dropbox paths begin with /; use an empty string for the account root.