Dropbox API v2
Browse all Dropbox APIsAgent-ready OpenAPI document · curated by JenticStorageDocument Managementoauth278 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Upload, download, and organize files in Dropbox cloud storage. Share files with configurable permissions and track revision history across folders.
Use for: I need to upload a file to a specific Dropbox folder, I want to share a file with a password-protected link, Search for all PDF files modified in the last week, Get a temporary download link for a large file
Not supported: Does not handle e-signatures, fax, or document editing - use for cloud file storage, sync, and sharing only.
Jentic publishes the only available OpenAPI specification for Dropbox API v2, keeping it validated and agent-ready. Store, sync, and share files across devices through programmatic access to Dropbox cloud storage. Upload and download files, organize folder hierarchies, control sharing permissions, and track file revisions across 78 endpoints. The API handles both small file operations via RPC-style calls and large file transfers through chunked upload sessions.
Install Jentic One Beta
Connect the Dropbox API v2 to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Dropbox API v2, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdropbox.com%2Fdropbox-api-v2" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fdropbox.com%2Fdropbox-api-v2" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Dropbox API v2 API.
Upload files up to 150 MB in a single call or use chunked upload sessions for larger files
Search across an entire Dropbox account by filename, content, or file extension with pagination
Generate temporary download links with configurable expiry for secure file distribution
Lock and unlock files to prevent concurrent editing conflicts in shared folders
Track and restore previous file versions with full revision history
Configure shared link permissions including password protection and expiry dates
Tag files with custom metadata for organization and filtering
Use Cases
Patterns agents use Dropbox API v2 API for, with concrete tasks.
★ AI Agent File Storage Integration
AI agents store and retrieve generated artifacts - reports, images, code outputs - directly in Dropbox via Jentic. The agent searches for the upload operation by intent, receives the schema, and executes the upload without browsing documentation. Chunked upload sessions handle files over 150 MB automatically, and the agent can verify completion status through job polling endpoints.
Upload a 5 MB report PDF to /reports/2026/monthly-summary.pdf using the /2/files/upload endpoint and verify the file metadata in the response
Secure File Sharing with External Partners
Share files and folders with external collaborators through configurable shared links. Set password protection, expiry dates, and access levels (view-only or edit) per link. The API supports creating shared links for individual files or entire folders, listing existing links, and modifying or revoking access at any time.
Create a shared link for /contracts/agreement.pdf with a password and 7-day expiry using /2/sharing/create_shared_link_with_settings
Document Version Control and Recovery
Track file changes over time with automatic versioning and restore any previous state. The API stores revision history for files, allowing retrieval of metadata for past versions and restoration of overwritten or deleted content. File locking prevents concurrent edits in team environments, reducing merge conflicts on shared documents.
List all revisions of /docs/proposal.docx using /2/files/list_revisions and restore the version from two days ago with /2/files/restore
Automated Folder Synchronization and Backup
Monitor folder contents for changes using long-poll cursors and synchronize local systems with Dropbox in near real-time. The list_folder/continue endpoint with a cursor tracks incremental changes (adds, edits, deletions) without re-scanning entire directories. Batch operations move or copy hundreds of files in a single API call for efficient migrations.
Get a cursor for /project-files using /2/files/list_folder, then poll for changes with /2/files/list_folder/continue to detect new or modified files
Key Endpoints
78 endpoints — jentic publishes the only available openapi specification for dropbox api v2, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/2/files/list_folder
List contents of a folder with pagination support
POST
/2/files/get_metadata
Get metadata for a file or folder by path
POST
/2/files/search_v2
Search for files and folders by name or content
POST
/2/files/create_folder_v2
Create a new folder at the specified path
POST
/2/files/delete_v2
Delete a file or folder at a given path
POST
/2/files/copy_v2
Copy a file or folder to a new location
POST
/2/sharing/create_shared_link_with_settings
Create a shared link with custom permissions
POST
/2/files/upload_session/start
Begin a chunked upload session for large files
POST
/2/files/list_folder
List contents of a folder with pagination support
POST
/2/files/get_metadata
Get metadata for a file or folder by path
POST
/2/files/search_v2
Search for files and folders by name or content
POST
/2/files/create_folder_v2
Create a new folder at the specified path
POST
/2/files/delete_v2
Delete a file or folder at a given path
POST
/2/files/copy_v2
Copy a file or folder to a new location
POST
/2/sharing/create_shared_link_with_settings
Create a shared link with custom permissions
POST
/2/files/upload_session/start
Begin a chunked upload session for large files
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Dropbox API by hand means running its OAuth 2.0 flow, mapping file and sharing scopes, and routing calls across its separate API, content, and notify hosts. Through Jentic you install once, import Dropbox from the API Directory, store the credentials once, and your agent calls it.
Permission scoping
Dropbox names the target file or folder in the request body and governs access through OAuth scopes like files.content.read and sharing.write, so you limit the agent to the operations it needs, such as listing a folder or creating a shared link. You grant only the matching scopes, so a destructive call like delete is not included unless you add it.
Credential isolation
Your Dropbox OAuth client secret and refresh token are stored once, encrypted, by your own Jentic One instance and exchanged for scoped access tokens at execution time. Raw secrets and refresh tokens never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'upload a file to Dropbox' or 'create a shared link', and Jentic returns the matching operation with its input schema, including headers like Dropbox-API-Arg, so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Dropbox API v2 API through Jentic.
Why is there no official OpenAPI spec for Dropbox API v2?
Dropbox does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Dropbox API v2 via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Dropbox API v2 use?
The Dropbox API v2 uses OAuth 2.0 for authentication. Apps obtain an access token through the OAuth flow and include it as a Bearer token in the Authorization header. Through Jentic, OAuth tokens are stored encrypted in your Jentic One instance - agents receive scoped access without handling raw tokens directly.
Can I upload files larger than 150 MB with the Dropbox API v2?
Yes. Files up to 150 MB can be uploaded in a single call. For larger files, use the chunked upload session endpoints: start a session with /2/files/upload_session/start, append chunks with /2/files/upload_session/append_v2, and finalize with /2/files/upload_session/finish. Sessions support files up to 350 GB.
How do I search for files in Dropbox through Jentic?
Search Jentic for the intent 'search for files in Dropbox' to load the /2/files/search_v2 operation schema. This endpoint searches by filename, file content, or extension across the entire account. Pass a query string and optional filters (file type, path, modification date) to narrow results. Install the SDK with pip install jentic to get started.
What are the rate limits for the Dropbox API v2?
Dropbox enforces per-app and per-user rate limits. Individual apps are limited to roughly 1,000 calls per user per 5 minutes for most endpoints. Write-heavy endpoints like upload and batch operations have lower limits. The API returns HTTP 429 with a Retry-After header when limits are exceeded.
Can I track file changes in real-time with the Dropbox API v2?
The API supports near-real-time change detection through cursor-based polling. Call /2/files/list_folder to get an initial cursor, then use /2/files/list_folder/continue to receive only new changes. For immediate notification, the long-poll endpoint at https://notify.dropboxapi.com/2/files/list_folder/longpoll blocks until changes occur or times out after a configurable interval.
Can I limit what my agent is allowed to do with the Dropbox API v2?
Yes. Because Jentic One is self-hosted, you set the rules that decide which Dropbox operations and credentials your agent may use. You grant only the OAuth scopes the task needs, such as files.content.read for listing a folder or sharing.write for creating a shared link, so a destructive call like /2/files/delete_v2 is unavailable unless you explicitly add its scope. Since each request names the target file or folder in its body, you can keep the agent confined to specific operations and paths while your stored credentials are exchanged for scoped tokens at execution time.
GET STARTED