storage
Dropbox CLI for CI
Use the Dropbox CLI for CI with headless JSON commands, schema discovery, credentials, and permission controls.
17 functions 10 read 7 write Manual OAuth token auth
Dropbox CLI for CI
Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status.
Use this shape when a pipeline needs to read or update an external service. The Dropbox CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Dropbox CLI for CI
kosmokrator integrations:configure dropbox --set access_token="$DROPBOX_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call dropbox.dropbox_list_folder '{"path":"example_path","recursive":true,"limit":1}' --json Discovery Before Execution
Agents and scripts can inspect Dropbox docs and schemas before choosing a function.
kosmo integrations:docs dropbox --json
kosmo integrations:docs dropbox.dropbox_list_folder --json
kosmo integrations:schema dropbox.dropbox_list_folder --json
kosmo integrations:search "Dropbox" --json
kosmo integrations:list --json Useful Dropbox CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
dropbox.dropbox_list_folder | Read | path, recursive, limit | List files and folders in a Dropbox directory. Use an empty string "" for the root path. Returns entries with name, path, size, and type. Use recursive=true to list all nested content. If has_more is true in the response, use dropbox_list_folder_continue with the cursor to fetch additional results. |
dropbox.dropbox_list_folder_continue | Read | cursor | Continue listing files and folders using the cursor from a previous dropbox_list_folder or dropbox_list_folder_continue call. Use this when the previous response has has_more=true. |
dropbox.dropbox_upload_file | Write | path, content, mode, autorename, mute | Upload a file to Dropbox. The file content is sent as the request body. Supports add (default), overwrite, and update write modes. The path must start with a slash (e.g., "/Documents/report.txt"). |
dropbox.dropbox_download_file | Read | path | Download a file from Dropbox. Returns the raw file content. The path must reference a file (not a folder). |
dropbox.dropbox_create_folder | Write | path, autorename | Create a new folder in Dropbox at the specified path. Parent folders are created automatically. Set autorename to true to avoid conflicts with existing folders. |
dropbox.dropbox_delete | Write | path | Delete a file or folder at the given path in Dropbox. This action can be undone within the recovery window by restoring the file from revisions. |
dropbox.dropbox_move | Write | from_path, to_path, autorename, allow_shared_folder | Move a file or folder to a new location in Dropbox. Both from_path and to_path are required. Set allow_shared_folder to true to move shared folders. |
dropbox.dropbox_copy | Write | from_path, to_path, autorename, allow_shared_folder | Copy a file or folder to a new location in Dropbox. Both from_path and to_path are required. Set allow_shared_folder to true to copy shared folders. |
dropbox.dropbox_search_files | Read | query, path, file_categories, max_results | Search for files and folders in Dropbox by name or content. Returns matching entries with metadata. Optionally filter by path or file category. If has_more is true, use dropbox_search_continue with the cursor. |
dropbox.dropbox_search_continue | Read | cursor | Continue a search using the cursor from a previous dropbox_search_files or dropbox_search_continue call. Use when the previous response has has_more=true. |
dropbox.dropbox_create_shared_link | Write | path, settings | Create a shared link for a file or folder in Dropbox. Optionally configure link settings such as access level, password, and expiry. |
dropbox.dropbox_list_shared_links | Read | path, cursor | List shared links for a specific file or folder, or list all shared links. Optionally filter by path or paginate with a cursor. |
dropbox.dropbox_get_temporary_link | Read | path | Get a temporary link to stream a file from Dropbox. The link expires after a short time. Returns both the file metadata and the temporary link URL. |
dropbox.dropbox_list_revisions | Read | path, limit | List revisions of a file in Dropbox. Returns previous versions with revision IDs that can be used with dropbox_restore to recover an earlier version. |
dropbox.dropbox_restore | Write | path, rev | Restore a file to a specific revision in Dropbox. Use dropbox_list_revisions to find the revision ID, then restore the file to that version. |
dropbox.dropbox_get_metadata | Read | path, include_media_info, include_deleted | Get metadata for a file or folder in Dropbox. Returns name, path, size, modified time, and type. Optionally include media info for photos/videos or include deleted files. |
dropbox.dropbox_get_current_account | Read | none | Get information about the currently authenticated Dropbox account, including display name, email, account type, and usage quota. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.