List the contents of a folder. Pass "" for the root. Set recursive=true to walk subfolders. If the result is truncated, call again with the returned cursor.

Get metadata (size, modified time, id, etc.) for a single file or folder.

Create a folder at the given path.

Move or rename a file or folder from one path to another.

Copy a file or folder to a new path.

Delete a file or folder (and its contents). Destructive — the item moves to deleted state and can be restored from Dropbox for the retention window.

Get a direct, time-limited (~4h) download/streaming URL for a file. Use this to reference or fetch file contents without creating a permanent shared link.

Download a file and return its contents as UTF-8 text — for referencing docs, notes, code, csv, etc. Guarded by DROPBOX_MAX_READ_BYTES (default 5 MB). For large or binary files use dropbox_get_temporary_link instead.

Upload content to a path. Provide either text (inline UTF-8) or localPath (a file on this machine to read). Files at/under ~140 MB go in a single request; larger local files are streamed in chunks via an upload session automatically.

Search the account for files and folders matching a query (filename and, where indexed, content). Optionally scope to a folder. If the result has_more, call again with the returned cursor.

Create a shareable link for a file or folder. If a link already exists for the path, the existing link is returned instead of erroring.

List existing shared links, optionally for a specific path. Paginates via cursor.

Look up metadata for an existing shared link URL.

Disable a shared link so the URL no longer grants access.

Return the authenticated account (name, email, account id, team). Good for confirming the server is connected to the right Dropbox.

Return storage usage and allocation for the account.