check_job_status
ChatGPTTool Name: dropbox.check_job_status Purpose: Poll an async move, copy, delete, or restore_folder operation. REQUEST CONTRACT: - operation_id (required): the opaque token returned by move, copy, delete, or restore_folder. - wait_ms (optional): wait budget in milliseconds. Omitted or 0 performs one immediate status check. Positive values ask the server to wait briefly for completion. Maximum 30000ms; values >30000 or negative are rejected with INVALID_WAIT_MS. RESPONSE CONTRACT: - status: "completed" or "in_progress". - operation_id: echoed when status="in_progress". Pass it back unchanged for the next poll. - recommended_poll_after_ms: suggested delay before the next poll. - When status="completed", result_type and the populated result field are: - result_type="move" with move_result. - result_type="copy" with copy_result. - result_type="delete" with delete_result. - result_type="restore_folder" with restore_folder_result. ASSISTANT POLICY: - Use this tool only when move, copy, delete, or restore_folder returns an operation_id. - Do not assume every async Fileverse MCP tool uses check_job_status. Follow the submission tool's polling instructions. - Pass operation_id back verbatim. Do not alter, truncate, or encode/decode it. - Respect recommended_poll_after_ms; do not poll in a tight loop. - When status becomes "completed", read result_type and use the matching result field listed above. - Follow the submission tool's instructions for operation-specific results, errors, retries, and user-facing guidance. EXAMPLES: {"operation_id": "<token from previous in_progress response>"} {"operation_id": "<token>", "wait_ms": 5000}
check_upload_file_status
ChatGPTTool Name: dropbox.check_upload_file_status Purpose: Poll an in-progress upload_file operation. REQUEST CONTRACT: - operation_id (required): Opaque token returned by upload_file when status="in_progress". - wait_ms (optional): Wait budget in milliseconds. Omitted or 0 performs one immediate status check. Maximum 30000ms. RESPONSE CONTRACT: When status is "in_progress": - status: "in_progress" - operation_id: Pass back unchanged on the next check. - recommended_poll_after_ms: Suggested delay before polling again. When status is "completed": - status: "completed" - file: Saved file metadata with name, path, modified_time, file_id, object_type, file.size, and path_display when available. - modified_time is the server-side modification time, in ISO 8601 format when available. - Prefer path_display when present and non-empty, both when showing the saved file to the user and in follow-on MCP calls. Otherwise use path or file_id exactly as returned. ERRORS: - INVALID_OPERATION_ID: operation_id is missing, malformed, expired, or belongs to a different user. - INVALID_WAIT_MS: wait_ms is negative or greater than 30000. - FETCH_FAILED: Dropbox could not download the source URL. - CONTENT_HASH_MISMATCH: the completed file did not match the expected content hash and cleanup was attempted. ASSISTANT POLICY: - Use only with an operation_id returned by upload_file. - Pass operation_id back verbatim. Do not alter, truncate, or encode/decode it. - Respect recommended_poll_after_ms; do not poll in a tight loop. - Do not claim the file was saved until status="completed". EXAMPLES: {"operation_id": "<token from upload_file>"} {"operation_id": "<token from upload_file>", "wait_ms": 5000}
client_log_proxy
ChatGPTInternal MCP app widget bridge for client logging events.
copy
ChatGPTTool Name: dropbox.copy Purpose: Copy one or more files/folders in Dropbox as a single batch. When to use: Any time the user asks to duplicate files or folders into another location. Prefer copy over download-and-reupload. PATHS: - Each entry's source_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt". - destination_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt"; Dropbox resolves lookup, conflicts, and destination semantics. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Dropbox may create missing destination parent folders during the copy; no need to pre-create parent folders unless the user explicitly asks. - Paths are case-insensitive; the same entry can cross between fq_path, ns_path, and file_id forms if needed. - Successful entries may return object.path as ns_path and object.path_display as fq_path. Prefer object.path_display when present and non-empty, both when showing paths to the user and in follow-on tool calls. If path_display is absent or empty, fall back to object.path or object.file_id exactly as returned. - Never strip the "ns:<id>//" prefix from returned ns_path values. REQUEST CONTRACT: - entries (required, 1..1000): list of { source_path, destination_path } pairs. - autorename (optional, default false): when true, Dropbox renames the destination to avoid a conflict instead of failing that entry. RESPONSE CONTRACT (flat lifecycle fields, MIRROR of move/delete): When status is "completed": - status: "completed" - result_type: "copy" - copy_result.entries[]: per-entry records in request order. - entry_index: 0-based index into the original entries list. - entry_status: "success" or "failed". - object (on success): { name, file_id, object_type: "file"|"folder", path_display, file.size when file, modified_time }. - failure (on failure): { error_code, message }. When status is "in_progress": - status: "in_progress" - operation_id: opaque token to pass to dropbox.check_job_status. - recommended_poll_after_ms: suggested delay before the next check_job_status call. Job-level failures are returned as tool errors. Per-entry failures are returned in copy_result.entries[] when status is "completed". ERRORS (job-level): - INVALID_REQUEST: entries is empty, nil, or malformed - INVALID_ENTRY: an entries item is missing source_path or destination_path - INVALID_PATH: source_path is not a valid fq_path/ns_path/file_id value, or destination_path is not a valid fq_path/ns_path/file_id value - TOO_MANY_ENTRIES: more than 1000 entries submitted in one call - INVALID_ARGUMENT: Dropbox rejected the batch as malformed ERRORS (per-entry error_code values): - Source lookup failures use from_lookup/ codes, such as from_lookup/not_found, malformed paths, non-file/non-folder targets, restricted content, unsupported content type, or locked content. - Source write failures use from_write/ codes for conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Destination write failures use to/* codes for destination conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Shared-folder, batch, permission/quota, and temporary failures include cant_copy_shared_folder, cant_nest_shared_folder, duplicated_or_nested_paths, too_many_files, cant_transfer_ownership, insufficient_quota, too_many_write_operations, and internal_error. - unknown_error means Dropbox returned an error variant this tool does not recognize. DUPLICATE DESTINATION QUIRK: - For duplicate destinations in one batch, later entries may report from_write/conflict even though the practical cause is a destination collision. Report it to the user as a destination conflict. RETRY GUIDANCE: - If status is "in_progress", call dropbox.check_job_status with the returned operation_id. - Do NOT retry the entire batch on per-entry failures; report the specific failures to the user. - too_many_write_operations and internal_error are transient — retry after a short delay if appropriate. EXAMPLES: {"entries": [{"source_path": "/Docs/report.txt", "destination_path": "/Backup/report.txt"}]} {"entries": [{"source_path": "ns:123//A.txt", "destination_path": "ns:123//Archive/A.txt"}], "autorename": true} {"entries": [{"source_path": "id:AbCd-_12", "destination_path": "/Shared/duplicate.pdf"}]} {"entries": [{"source_path": "/Docs/source.pdf", "destination_path": "id:AbCd-_12/copy.pdf"}]} ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided.
create_file
ChatGPTTool Name: dropbox.create_file Purpose: Create a new file with text content in Dropbox. When to use: For creating text-oriented files from inline content only. PATHS (SUPER IMPORTANT): - Input path accepts fq_path or ns_path. - Paths are case-insensitive. - The final path component is the filename to create. - Output file.path is always ns_path. - Never strip the "ns:<id>//" prefix from returned paths. - Team root is not writable for team accounts. Personal account root is writable. - This tool only supports text-oriented files. Allowed extensions: - .abap - .ada - .adp - .ahk - .as - .as3 - .asc - .ascx - .asm - .asp - .aspx - .awk - .bash - .bash_login - .bash_logout - .bash_profile - .bashrc - .bat - .bib - .bsh - .build - .builder - .c - .c++ - .capfile - .cc - .cfc - .cfm - .cfml - .cl - .clj - .cls - .cmake - .cmd - .coffee - .cpp - .cpt - .cpy - .cs - .cshtml - .cson - .csproj - .css - .csv - .ctp - .cxx - .d - .ddl - .di - .dif - .diff - .disco - .dml - .dtd - .dtml - .el - .emakefile - .erb - .erl - .f - .f90 - .f95 - .fs - .fsi - .fsscript - .fsx - .gemfile - .gemspec - .gitconfig - .go - .groovy - .gry - .gvy - .h - .h++ - .haml - .handlebars - .hbs - .hcp - .hh - .hpp - .hrl - .hs - .htc - .htm - .html - .hxx - .idl - .iim - .inc - .inf - .ini - .inl - .ipp - .irbrc - .jade - .jav - .java - .js - .json - .jsp - .jsx - .l - .less - .lhs - .lisp - .log - .lst - .ltx - .lua - .m - .make - .markdn - .markdown - .md - .mdown - .mkdn - .ml - .mli - .mll - .mly - .mm - .mud - .nfo - .opml - .org - .osascript - .out - .p - .pas - .patch - .php - .php2 - .php3 - .php4 - .php5 - .phtml - .pl - .plist - .pm - .pod - .pp - .profile - .properties - .ps1 - .psd1 - .psm1 - .pt - .py - .pyw - .r - .rake - .rb - .rbx - .rc - .re - .readme - .reg - .rest - .resw - .resx - .rhtml - .rjs - .rprofile - .rpy - .rs - .rss - .rst - .rxml - .s - .sass - .scala - .scm - .sconscript - .sconstruct - .script - .scss - .sgml - .sh - .shtml - .sml - .sql - .sty - .swift - .tcl - .tex - .text - .textile - .tld - .tli - .tmpl - .tpl - .tsx - .txt - .vb - .vi - .vim - .wsdl - .xhtml - .xml - .xoml - .xsd - .xsl - .xslt - .yaml - .yaws - .yml - .zsh REQUEST CONTRACT: - path (string, REQUIRED): Full destination path including the filename. - Parent must already exist. - content (string, REQUIRED): UTF-8 text content. Maximum 5MB. RESPONSE CONTRACT: - file: object describing the created file. - name, path, modified_time, file_id - object_type: "file" - file.size: File size in bytes. - path_display: fq_path for human display when populated. - When content is empty, current MCP serialization may omit file.size instead of returning 0. Treat an omitted size as a zero-byte file. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file IDs, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. For created files or folders, instruct the user to delete them from Dropbox. For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI. ERRORS: - INVALID_PATH: path is empty or missing name component - INVALID_NAME: name contains \ (backslash) - CONTENT_TOO_LARGE: content exceeds 5MB - PARENT_NOT_FOUND: parent path doesn't exist - PARENT_NOT_FOLDER: parent is not a folder - ALREADY_EXISTS: file exists at target - PERMISSION_DENIED: no write access - TEAM_ROOT_NOT_WRITABLE: cannot create files or folders directly in team root RETRY GUIDANCE: - Do NOT retry on TEAM_ROOT_NOT_WRITABLE. Choose a specific folder path instead. EXAMPLES: {"path": "/Documents/notes.txt", "content": "Hello World"} {"path": "ns:123//Code/script.py", "content": "print('hi')"} {"path": "/readme.txt", "content": "Root level file"}
create_file_request
ChatGPTTool Name: dropbox.create_file_request Purpose: Create a Dropbox file request that lets other people upload files into a chosen Dropbox destination. When to use: Use this when the user wants a Dropbox file request, upload request, upload link, submission link, or a way for other people to upload, submit, collect, or receive files into the user's Dropbox. This creates a public upload URL for contributors to add files to the chosen destination folder; it is not for giving people view or download access to existing Dropbox content. REQUEST CONTRACT: - Shape: {"title": "<title>", "destination": "/Requests/Invoices", "deadline": "2026-05-04T17:00:00Z", "deadline_allow_late_uploads": "seven_days", "closed": false, "description": "...", "video_project_id": "..."} - title (string, REQUIRED): File request title. Must be non-empty. - destination (string, REQUIRED): Destination folder path. Accepts fq_path, ns_path, or file_id. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. Dropbox shared/web URLs are not accepted. Dropbox rejects file requests at a team root, such as "/", or the user's personal root, such as "/FirstName LastName"; use a child folder under that folder, such as "/FirstName LastName/Invoices". If the destination folder does not exist and the user has write permission to the parent folder, the destination folder will be created automatically. Avoid surprising destinations; confirm the exact destination with the user before creating. - deadline (string, optional): RFC3339 timestamp, for example "2026-05-04T17:00:00Z". If omitted, the file request has no deadline and accepts uploads indefinitely until the request is manually closed or deleted. Setting a deadline requires an eligible Dropbox plan: Professional, Essentials, Business, Business Plus, Standard, Advanced, or Enterprise. Basic, Plus, and Family accounts cannot set a deadline; Dropbox will reject the request for users on these plans. - deadline_allow_late_uploads (string, optional): Valid only when deadline is present. Allowed values: "one_day", "two_days", "seven_days", "thirty_days", or "always". - closed (bool, optional): Defaults to false. false creates an open request; true creates a closed request. - description (string, optional): Optional instructions shown on the file request. - video_project_id (string, optional): Optional Dropbox video editor project ID for associating uploads from this file request with that project. Only pass this when the user or an upstream Dropbox workflow provides the exact project ID. This tool does not verify the project before creating the file request. If the ID is invalid or inaccessible, later uploads can still succeed, but Dropbox may fail to attach the uploaded files to the video project. RESPONSE CONTRACT: - file_request: Created file request record. - id: File request ID. - url: Public upload URL. - title: File request title. - destination: Destination folder path. - created: ISO 8601 creation timestamp. - deadline: ISO 8601 deadline timestamp. Empty when unset. - deadline_allow_late_uploads: Grace period string. Empty when unset. - is_open: Whether the created request accepts uploads. - file_count: Number of submitted files. - description: Optional description. Empty when unset. - video_project_id: Optional video editor project ID. Empty when unset. ASSISTANT POLICY: - Confirm with the user before calling this tool. - Do not claim the file request was created until this tool returns a successful response. - Return the created file request URL, title, destination, open/closed state, and deadline when present. - Avoid creating requests in unexpected destinations without explicit user confirmation. - If the destination is a team root or the user's personal root, ask the user to confirm a child folder under that folder. Do not silently retry with a guessed child folder. - This tool creates metadata only. It does not update, close, delete, or submit files to a request. - After a successful response that creates an open file request, tell the user they can close it from Dropbox and include https://help.dropbox.com/share/create-file-request. - If the destination folder does not exist and the user has write permission to the parent folder, the destination folder will be created automatically. Do not pass guessed, placeholder, or unverified paths. If the user expects an existing folder, verify the destination before creating the request. - You cannot reliably know the user's plan tier in advance. If the user asks for a deadline and the create call fails with a plan-tier error, do not silently retry without a deadline. Explain that deadlines require an eligible plan (Professional, Essentials, Business, Business Plus, Standard, Advanced, or Enterprise) and obtain a second explicit confirmation from the user before creating the request without a deadline. - If the user is on Basic, Plus, or Family, or declines a deadline, proceed without one and explicitly warn that the request will remain open until they close or delete it. EXAMPLES: {"title": "Invoice uploads", "destination": "/Requests/Invoices"} {"title": "Invoice uploads", "destination": "id:AbCd-_12"} {"title": "Video assets", "destination": "/Projects/Launch", "deadline": "2026-05-04T17:00:00Z", "deadline_allow_late_uploads": "seven_days", "description": "Upload final cuts here."}
create_folder
ChatGPTTool Name: dropbox.create_folder Purpose: Create a new folder in Dropbox. PATHS (SUPER IMPORTANT): - Input path accepts fq_path (for example "/Documents/NewFolder") or ns_path (for example "ns:123//Documents/NewFolder"). - Paths are case-insensitive. - The final path component is the new folder name. - Output folder.path is always ns_path. - Never strip the "ns:<id>//" prefix from returned paths. - Team root is not writable for team accounts. Personal account root is writable. REQUEST CONTRACT: - path (string, REQUIRED): Full destination path including the new folder name. - Parent must already exist. - To create nested parents, call create_folder for the parents first. RESPONSE CONTRACT: - folder: object describing the created folder. - name: Folder name. - path: ns_path for follow-on MCP calls. - modified_time: ISO 8601 when available. - file_id: Encoded object id. Can be reused as "id:<file_id>". - object_type: "folder". - folder: Empty object. - path_display: fq_path for human display when populated. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file IDs, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. For created files or folders, instruct the user to delete them from Dropbox. For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI. ERRORS: - INVALID_PATH: path is empty or missing name component - INVALID_NAME: name contains \ (backslash) - PARENT_NOT_FOUND: parent path doesn't exist - PARENT_NOT_FOLDER: parent is not a folder - ALREADY_EXISTS: folder already exists at target path - PERMISSION_DENIED: no write access - TEAM_ROOT_NOT_WRITABLE: cannot create files or folders directly in team root RETRY GUIDANCE: - Do NOT retry on TEAM_ROOT_NOT_WRITABLE. Choose a specific folder path instead. EXAMPLES: {"path": "/Documents/NewFolder"} {"path": "ns:123//Projects/Archive"} {"path": "/NewFolderAtRoot"} Limitations: This tool only creates folders. It cannot rename or delete existing folders.
create_shared_link
ChatGPTTool Name: dropbox.create_shared_link Purpose: Create or reuse a private shared link and optionally add viewers by email. When to use: Only when the user explicitly asks to share, get a link, or send a file/folder to someone. Do NOT call automatically after create_file or upload_file. PATHS (SUPER IMPORTANT): - Input path_or_file_id accepts fq_path, ns_path, or "id:<file_id>". - Paths are case-insensitive. "/Documents/File.txt" and "/documents/file.txt" resolve to the same object. - Never strip the "ns:<id>//" prefix from returned paths. REQUEST CONTRACT: - path_or_file_id (string, REQUIRED): File or folder identifier. - emails (string[], OPTIONAL): Viewers to add directly. - Maximum 25 emails. - Empty strings are filtered out before the limit is checked. - Control characters (\r, \n, \t, etc.) are rejected with INVALID_EMAIL. - audience (string, OPTIONAL): Must be "no_one" or omitted. - access_level (string, OPTIONAL): Must be "view" or omitted. - password (string, OPTIONAL): Password protection when supported. - expires (string, OPTIONAL): ISO 8601 expiration when supported. - allow_download (bool, OPTIONAL): Whether recipients can download. RESPONSE CONTRACT: - url: The shared link URL. Always present. - created: Whether this is a newly created link (true) or a pre-existing one (false). - warning: Only present when created=false and the existing link's settings do not match what was requested. Lists which settings differ. No changes were made to the link. - audience: Effective audience. "no_one" for new links; existing links report their actual audience. - access_level: Effective access level. "view" for new links; existing links report their actual level. - password_protected: Whether the link has a password set. - expires: Expiration timestamp (RFC 3339) or empty. - allow_download: Whether download is enabled. - content_type: "file" or "folder". - path: ns_path for the shared object. Use this for follow-on MCP calls. - path_display: Human-readable fq_path. - The filename in url may be sanitized. Treat path and path_display as the authoritative original name. - shared_with and share_errors: When member addition is attempted or skipped because warning is present, both fields are returned as a pair. - shared_with: Emails successfully added as viewers (may be empty). - share_errors: Email-specific member-add errors, or the reason member addition was skipped (may be empty). - Link creation and member addition are separate steps, so a link may be created even when all email additions fail. HOW TO INTERPRET THE RESPONSE: - created=true → New link created with the requested settings. If emails were provided, member addition was attempted. - created=false, no warning → Existing link matches the requested settings. If emails were provided, member addition was attempted. - created=false, warning present → Existing link has different settings. No link settings were changed. If emails were provided, member addition was skipped and share_errors explains why. CRITICAL INSTRUCTION FOR CLIENTS: - If warning is present, you MUST present the returned url and effective settings to the user as the current existing link state. - If warning is present, you MUST make it explicit to the user that the existing link settings differ from what was requested. - If warning is present, you MUST make it explicit to the user that no members were added from this request. REUSE BEHAVIOR: - This tool cannot modify an existing link. If a link already exists, its current URL and settings are returned as-is. - When the existing link matches the request (ACL-only, viewer, and any explicitly requested password/expiry/download settings), it is reused silently. - When settings differ, the warning field names the specific mismatches. Member addition is skipped to avoid granting access under unexpected link settings. - Once created, link settings (allow_download, password, expires) cannot be changed via this tool. SIDE EFFECTS: - Sharing a regular folder converts it to a shared folder (mount). Its namespace path will change in subsequent list_folder results. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file IDs, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. For created files or folders, instruct the user to delete them from Dropbox. For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI. ERROR CASES: - SETTINGS_NOT_AUTHORIZED: Account or policy does not allow the requested password, expiry, or download setting - INVALID_AUDIENCE: Non-ACL_ONLY audience specified - INVALID_ACCESS_LEVEL: Non-view access_level specified - INVALID_EMAIL: Email contains control characters - TOO_MANY_EMAILS: More than 25 emails provided - MISSING_PATH: path_or_file_id is empty - INVALID_FILE_ID: file_id format is invalid - FILE_NOT_FOUND: target file or folder does not exist - INVALID_SETTINGS: target cannot be shared (e.g., root path, member folder mount) - INVALID_EXPIRES: expires is malformed or in the past - RATE_LIMIT_EXCEEDED: request exceeded tool rate limits EXAMPLES: {"path_or_file_id": "/Documents/report.pdf"} {"path_or_file_id": "/Documents/report.pdf", "emails": ["alice@example.com", "bob@example.com"]} {"path_or_file_id": "id:abc123", "emails": ["team@example.com"]}
delete
ChatGPTTool Name: dropbox.delete Purpose: Delete one or more files/folders in Dropbox as a single batch. When to use: Any time the user asks to delete, remove, or trash files or folders. DELETE SEMANTICS: - Delete moves each entry to the user's Dropbox "Deleted files" area; it is NOT a permanent wipe. The user can restore deleted items through the Dropbox web/desktop UI. - If the user explicitly asks for permanent deletion, this tool does NOT support that. Warn the user and stop — do not proceed. PATHS: - Each entry's source_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt". - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive; the same entry can cross between fq_path, ns_path, and file_id forms if needed. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Successful entries return object metadata captured at deletion time (not a tombstone). object.path is ns_path; object.path_display is fq_path. Prefer object.path_display when present and non-empty, both when showing paths to the user and in follow-on tool calls. If path_display is absent or empty, fall back to object.path or object.file_id exactly as returned. - Never strip the "ns:<id>//" prefix from returned ns_path values. REQUEST CONTRACT: - entries (required, 1..1000): list of { source_path } entries. RESPONSE CONTRACT (flat lifecycle fields, MIRROR of move/copy): When status is "completed": - status: "completed" - result_type: "delete" - delete_result.entries[]: per-entry records in request order. - entry_index: 0-based index into the original entries list. - entry_status: "success" or "failed". - object (on success): { name, file_id, object_type: "file"|"folder", path_display, file.size when file, modified_time } — metadata at deletion time. - failure (on failure): { error_code, message }. When status is "in_progress": - status: "in_progress" - operation_id: opaque token to pass to dropbox.check_job_status. - recommended_poll_after_ms: suggested delay before the next check_job_status call. Job-level failures are returned as tool errors. Per-entry failures are returned in delete_result.entries[] when status is "completed". ERRORS (job-level): - INVALID_REQUEST: entries is empty, nil, or malformed - INVALID_ENTRY: an entries item is missing source_path - INVALID_PATH: source_path is not a valid fq_path/ns_path/file_id value - TOO_MANY_ENTRIES: more than 1000 entries submitted in one call - INVALID_ARGUMENT: Dropbox rejected the batch as malformed - DELETE_BATCH_FAILED: async job reported a job-level failure during polling ERRORS (per-entry error_code values): - Path lookup failures use path_lookup/ codes, such as path_lookup/not_found, malformed paths, non-file/non-folder targets, restricted content, unsupported content type, or locked content. - Path write failures use path_write/ codes for conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Transient/batch failures include too_many_write_operations, too_many_files, and internal_error. - unknown_error means Dropbox returned an error variant this tool does not recognize. RETRY GUIDANCE: - If status is "in_progress", call dropbox.check_job_status with the returned operation_id. - Do NOT retry the entire batch on per-entry failures; report the specific failures to the user. - too_many_write_operations and internal_error are transient — retry after a short delay if appropriate. EXAMPLES: {"entries": [{"source_path": "/Docs/old.txt"}]} {"entries": [{"source_path": "ns:123//Archive/A.txt"}, {"source_path": "ns:123//Archive/B.txt"}]} {"entries": [{"source_path": "id:AbCd-_12"}]} ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided.
download_link
ChatGPTTool Name: dropbox.download_link Purpose: Generate single-use temporary download links for Dropbox files. PATHS: - Input entries accepts fq_path, ns_path, or file_id. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Never strip the "ns:<id>//" prefix from values returned by other tools before passing them here. - Entries must refer to files. Folders are not downloadable through this tool. REQUEST CONTRACT: - entries (string[], REQUIRED): One or more file identifiers. Maximum 25 entries per request. - Path formats: fq_path such as "/Documents/report.pdf" or ns_path such as "ns:123//Documents/report.pdf". - file_id format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12". - expiration_in_sec (uint32, optional): Link lifetime in seconds. Defaults to 600 when omitted or 0. Valid values are 0 (use default) or 60-900. BATCH SEMANTICS: - If any entry is invalid or cannot be linked, the entire call fails with a tool error. The response does not include per-entry success/failure records. - For mixed-quality batches, verify inputs first with get_file_metadata or list_folder, or split the call into per-entry requests. RESPONSE CONTRACT: - entries[]: Temporary download link records, in request order. Only populated when all requested entries resolve successfully. - download_url: Single-use temporary URL for file content. - expiration_in_sec: Link lifetime in seconds. - path: ns_path for follow-on MCP calls. - path_display: fq_path for human display when populated. - name, id, size, content_hash, mime_type: File metadata for the linked file. SINGLE-USE URL: - The URL is consumed by the first HTTP request of any method, including HEAD and Range requests. Do not preview, unfurl, scan, or preflight it; request a new link if it is consumed or expires. - Anyone with the URL can fetch the user's file content with an unauthenticated HTTP GET. Treat download_url as sensitive and short-lived. Do not present it as a durable shared link. ASSISTANT POLICY: - Use this when the user needs an actual file download URL, not extracted text. For text inspection, prefer a different tool. - If a download fails, expires, or has already been consumed, request a new temporary link. - Do not use this for folders, CloudDocs, or Paper docs; they are not supported by temporary direct-download URLs. - Do not call create_shared_link automatically after this tool unless the user explicitly asks for a shareable Dropbox link. - When showing file identity to the user, MUST use path_display if present. Otherwise use path or id exactly as returned. EXAMPLES: {"entries": ["/Documents/report.pdf"]} {"entries": ["ns:123//Projects/image.png", "id:AbCd-_12"], "expiration_in_sec": 900}
dropbox_fetch_file
ChatGPTPrepare an exact file download or bounded export in the selected root. Recheck both the current account root and stable file identity. Return a provider-issued temporary URL for downloadable files, or a bounded export for non-downloadable files such as Paper. Never switch roots on failure.
dropbox_fetch_thumbnail
ChatGPTReturn a bounded provider-generated JPEG for trusted internal image previews. Resolve this exact file in the linked account's current home or team namespace. This action never downloads the original file or accepts caller-chosen roots.
dropbox_get_item_metadata
ChatGPTRead a stable item ID in its authenticated home or Team Space root. Unlike path resolution, this supports accessible shared items without mounted paths. Pass the returned root to subsequent private content reads.
dropbox_list_folder
ChatGPTBrowse one Dropbox folder page with typed file and folder metadata. Use the empty path for the connected account's home root. To browse a previously discovered folder, pass its path_display, path_lower, or stable id:<folder-id>. Mounted folders are included by default. Repeat optional object-type filters when continuing the provider cursor because filtering is applied locally. Programmatic team-root callers must first resolve a stable folder ID and pass its returned root unchanged.
dropbox_list_folder_continue
ChatGPTContinue exactly one Dropbox folder page while preserving caller-side filters. Use a folder-list cursor only, repeat the original file/folder filter when present, and pass prior stable IDs to suppress duplicates across pages. Repeat the root returned by dropbox_resolve_item_path for team-root listings.
dropbox_list_recently_modified_files
ChatGPTReturn files observed in a bounded, recursively scanned Dropbox home. Recency always means Dropbox server modification time, never file-access or view history. Observed files are sorted newest first, while folders and duplicate IDs are excluded. A continuation means the home-folder scan remains incomplete: the page is not guaranteed to contain the globally newest files. Resume with the returned cursor, its prior items, its continuation signature, and the same result limit so earlier verified files remain in the ranking. Each call reads one provider page and returns its accumulated ranking before another page is requested, preserving progress across caller deadlines.
dropbox_resolve_item_path
ChatGPTResolve a stable Dropbox item ID to its current authenticated scope. Use this private action before authorizing a mounted Library folder or file. It derives account roots from Dropbox, prefers the connected home namespace, falls back to the provider-owned team root only when the ID is absent from home, and re-reads every current folder ancestor. Missing, malformed, incomplete, or inconsistent ancestry fails closed. Pass a previously resolved root to keep subsequent item reads in that namespace; explicit roots are revalidated and never fall back to another namespace.
dropbox_search_continue
ChatGPTContinue exactly one provider-native Dropbox Search v2 result page. Pass only a search cursor, not a folder-list cursor. Repeat the initial file-only and modification-range filters because Dropbox cursors do not encode connector-side filtering. Pass prior stable item IDs to suppress duplicates across pages. Repeat the initial search's root when present.
dropbox_search_v2
ChatGPTSearch Dropbox with provider-native Search v2 filters and stable item metadata. Filename-only, stable folder ID or path scope, categories, extensions, and sort order are passed directly to Dropbox. File-only and modification-range filters are applied to each provider page; repeat them for its continuation. Unscoped searches include shared files, which have no path when unmounted. Explicit root selection requires a stable folder ID in path. Repeat the same root when continuing the search or resolving its matching item paths. Account-root search instead derives the current root from the linked credential, without accepting a caller-selected namespace or folder.
dropbox_upload_file
ChatGPTUpload file bytes into an exact Dropbox folder, failing on name conflicts. This private action requires write consent on the existing public app link. It never replaces an existing file or creates a different destination folder.
fetch
ChatGPTFetch full text content for a Dropbox file by id or path. REQUEST: - id: File identifier or Dropbox path (required string; accepts "id:<file_id>", fq_path, or ns_path) RESPONSE: - id: Same id-or-path token used for the request - title: Human-readable file title - text: Full extracted text content - url: Openable Dropbox URL for the file - metadata: Optional string fields such as path_display and server_modified NOTES: - Use the id returned by search directly with this tool, or pass an existing Dropbox path. - Use this tool when the user wants extracted text content from the file, such as reading, quoting, or summarizing the file's text. - For preview-oriented asks such as preview, show, open, inspect visually, or get a thumbnail/open-in-Dropbox experience, prefer file_preview instead. - This tool uses the existing Dropbox content extraction backend. - url prefers GetFileContent.content_link and falls back to GetFileMetadata.file.url when needed. - Max file size: 5 MiB. - If extraction fails, the tool returns an error instead of a partial success payload.
file_preview
ChatGPTReturn a list of FilePreviewData objects, each containing: - thumbnail_url: The thumbnail url of a given file. - file_type: The file type of the given file. - open_in_dropbox_url: A URL to open the file in Dropbox. - copy_link_url: A URL to copy a share link for the file. - file_name: The name of the file. - message: A description of the content if possible. USAGE: Provide a list of file paths, and the tool will return a list of FilePreviewData objects. Prefer this tool for preview-oriented asks such as preview, show, open, inspect visually, or get a thumbnail/open-in-Dropbox experience for a file. Use fetch instead only when the user explicitly wants extracted text content from the file. PATHS (VERY VERY IMPORTANT FOR TEAM ACCOUNTS): - fq_path (aka path_display/path_lower/fq_path): FullyQualified path from user root, e.g. "/RootFolder/folder1/file2" - ns_path (aka namespace path): Includes a namespace ID, e.g. "ns:123//RootFolder/folder1/file2" - Input path_or_file_id: accepts BOTH fq_path and ns_path, plus "id:<file_id>" - ALWAYS prefer "id:<file_id>" when available. - If "id:<file_id>" is not available, use ns_path. - Use fq_path/path_display only as a last resort when neither file_id nor ns_path is available. - Team/shared-space mounted display paths like "/Rahul Monga/App Testing/dbxlogo.png" can fail even when the same file works via "id:<file_id>" or ns_path. - NEVER truncate/convert an ns_path to an fq_path by removing the "ns:<id>//" prefix (this will be wrong!) REQUEST: - file_paths: The file paths to the files for the desired preview (required array of strings) RESPONSE: Returns a response with: - In structuredContent - results: An array of FilePreviewData objects, each containing: - thumbnail_url: The thumbnail url of a given file. - file_type: The file type of the given file. - open_in_dropbox_url: A URL to open the file in Dropbox. - copy_link_url: A URL to copy a share link for the file. - file_name: The name of the file. - message: A description of the content if possible. EXAMPLES: - Input: {"file_paths": ["id:abc123"]} → "{ results: [{ thumbnail_url: "www.dropbox.com/example-thumb.pdf", file_type: "pdf", open_in_dropbox_url: "www.dropbox.com/home/example.pdf", copy_link_url: "www.dropbox.com/scl/abc123", message: "some content description", file_name: "example.pdf"} ] }" - Input: {"file_paths": ["ns:123//Team Space/example.csv"]} → "{ results: [{ thumbnail_url: "www.dropbox.com/example-thumb.csv", file_type: "csv", open_in_dropbox_url: "www.dropbox.com/home/example.csv", copy_link_url: "www.dropbox.com/scl/def456", message: "some content description", file_name: "example.csv"} ] }" - Input: {"file_paths": ["/Documents/example.txt"]} → "{ results: [{ thumbnail_url: "www.dropbox.com/example-thumb.txt", file_type: "txt", open_in_dropbox_url: "www.dropbox.com/home/example.txt", copy_link_url: "www.dropbox.com/scl/ghi789", message: "some content description", file_name: "example.txt"} ] }" Private shared link requirement: This tool always generates a private shared link. Once you share the link you will need to approve their access from inside dropbox.
get_file_metadata
ChatGPTTool Name: dropbox.get_file_metadata Purpose: Get detailed metadata for a file or folder, including sharing info and permissions. PATHS (SUPER IMPORTANT): - Input path_or_file_id accepts fq_path, ns_path, or "id:<file_id>". - Output nested metadata uses fq_path fields such as path_display and path_lower. - Never strip the "ns:<id>//" prefix from values returned by other tools before passing them here. REQUEST CONTRACT: - path_or_file_id (string, REQUIRED): File or folder identifier. - Path formats: fq_path such as "/Documents/file.txt" or ns_path such as "ns:123//Documents/file.txt". - File id format: "id:encoded_file_id". RESPONSE CONTRACT: - metadata_type: "file" | "folder". Inspect this first. - file: Present only when metadata_type="file". - tag, id, name, path_display, path_lower - client_modified, server_modified - size, size_display, is_downloadable, mime_type, rev - size may be absent (not zero) for empty files due to proto serialization. Treat absent as zero. - sharing_info, permissions, url, ext, has_explicit_shared_members - folder: Present only when metadata_type="folder". - tag, id, name, path_display, path_lower - sharing_info, permissions, url - descendants_count, folder_size ASSISTANT POLICY: - Treat the response as nested. Do not assume there is a flat top-level tag, id, or name. - Do not assume both file and folder are present. - When using results from list_folder or search, pass the exact returned ns_path or "id:<file_id>". EXAMPLES: {"path_or_file_id": "/Documents/report.pdf"} {"path_or_file_id": "ns:123//Photos/image.png"} {"path_or_file_id": "id:a4ayc_80_OEAAAAAAAAAXw"}
get_file_request
ChatGPTTool Name: dropbox.get_file_request Purpose: Retrieve metadata for one Dropbox file request by raw file request ID. REQUEST CONTRACT: - Shape: {"id": "<file_request_id>"} - id (string, REQUIRED): Raw Dropbox file request ID. - Do not send a path, file id, or URL. This tool accepts only the raw file request ID. RESPONSE CONTRACT: - file_request: File request record. - id: File request ID. - url: Public upload URL. - title: File request title. - destination: Destination folder path. Empty when the destination was removed. - created: ISO 8601 creation timestamp. - deadline: ISO 8601 deadline timestamp. Empty when unset. - deadline_allow_late_uploads: Grace period string: "one_day", "two_days", "seven_days", "thirty_days", or "always". Empty when unset. - is_open: Whether the request accepts uploads. - file_count: Number of submitted files. - description: Optional description. Empty when unset. - video_project_id: Optional video project ID. Empty when unset. ASSISTANT POLICY: - Use this tool when the user asks about a specific Dropbox file request and you have its raw ID. - If the user provides a URL or path, ask for the raw file request ID. - This tool retrieves metadata only. It does not create, update, close, delete, or submit files to a request. EXAMPLES: {"id": "abc123"}
get_shared_link_metadata
ChatGPTTool Name: dropbox.get_shared_link_metadata Purpose: Get metadata for a shared link given its URL. When to use: When the user has a shared link URL and wants to know what it points to, who can access it, or what permissions it has. PARAMETERS: - url (string, required): The shared link URL to retrieve metadata for. RESPONSE CONTRACT: - link: Shared link metadata object. - url: The shared link URL. - link_type: "file", "folder", or "other". - name: Name of the linked file or folder. - path_lower: Lowercased path in the user's Dropbox. May be empty if the link is not in the authenticated user's Dropbox. - audience: Effective audience - "public", "team", or "no_one". - access_level: "view" or "edit". - expires: Expiration in RFC 3339 format. Empty if no expiration set. - allow_download: Whether download is allowed via this link. - password_protected: Whether the link requires a password. - id: file_id for the linked file/folder, if available. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. ASSISTANT POLICY: - Use this tool to inspect a shared link before taking action on it. - Do NOT call create_shared_link or list_shared_links unless the user explicitly asks. ERROR CASES: - MISSING_URL: The url field is empty. - NOT_FOUND: The shared link does not exist or has been revoked. - PERMISSION_DENIED: The authenticated user cannot access this shared link. - RATE_LIMIT_EXCEEDED: Request exceeded tool rate limits. EXAMPLES: {"url": "https://www.dropbox.com/s/abc123/report.pdf?dl=0"} {"url": "https://www.dropbox.com/sh/xyz789/shared-folder"}
list_file_requests
ChatGPTTool Name: dropbox.list_file_requests Purpose: List Dropbox file requests owned by the authenticated user with cursor-based pagination. REQUEST MODES: - First page: send {} or {"limit": 300}. limit is optional, defaults to 300 for this MCP tool, and must be between 0 and 1000. 0 means the default. Omit cursor for first pages. - Pagination: send {"cursor": "..."} only with a non-empty cursor from the previous response. Do not include limit with cursor. PARAMETERS: - limit (uint32, optional, first call only): Maximum page size. Default 300. Maximum 1000. Prefer 300 unless the user explicitly asks for larger pages. - cursor (string, pagination only): Opaque non-empty cursor from a previous list_file_requests response. Reuse only with list_file_requests pagination. Mutually exclusive with nonzero limit. RESPONSE CONTRACT: - file_requests[]: Array of file request records. - id: File request ID. - url: Public upload URL. - title: File request title. - destination: Destination folder path. Empty when the destination was removed. - created: ISO 8601 creation timestamp. - deadline: ISO 8601 deadline timestamp. Empty when unset. - deadline_allow_late_uploads: Grace period string: "one_day", "two_days", "seven_days", "thirty_days", or "always". Empty when unset. - is_open: Whether the request accepts uploads. - file_count: Number of submitted files. - description: Optional description. Empty when unset. - video_project_id: Optional video editor project ID. Empty when unset. - cursor: Opaque cursor for the next page. Empty when has_more=false. - has_more: Whether the server has more pages to scan. has_more=true means there is more data to scan but does not guarantee additional matching file requests; a page may return zero file requests with has_more=true. has_more=false means scanning is complete. Always paginate until has_more=false; do not infer completeness from file_requests count alone. PAGINATION: - Treat results as partial while has_more=true or cursor is non-empty. - Continue with cursor-only calls to enumerate additional pages. - Do not infer completeness from file_requests length alone. - Continue pagination to exhaustion before claiming all file requests, final counts, or no more file requests. - Pagination is live and not snapshot-stable. New file requests created after pagination begins may appear when continuing an existing cursor. Restart listing when the user wants a fresh view after mutations. ASSISTANT POLICY: - Use this tool when the user asks to see, list, count, audit, or summarize their Dropbox file requests. - If cursor is set, send cursor only and drop limit. - Ask before scanning many additional pages for exhaustive requests. EXAMPLES: {} {"limit": 300} {"limit": 100} {"cursor": "cursor_from_previous_response"}
list_file_revisions
ChatGPTTool Name: dropbox.list_file_revisions Purpose: List the revision history (prior versions) of a single Dropbox file. Use only when the user asks for prior versions, version history, or revisions. PATHS: - path_or_file_id accepts fq_path (for example "/Documents/file.txt"), ns_path (for example "ns:123//Documents/file.txt"), or file_id. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive and must be Unicode NFC-normalized. - Never strip the "ns:<id>//" prefix from returned paths. - Prefer path_display when present and non-empty, both when showing returned entries to the user and in follow-on MCP calls. If path_display is absent or empty, use ns_path or file_id exactly as returned only for tools that accept file_id. REQUEST CONTRACT: - path_or_file_id (string, REQUIRED): Target file identifier. - limit (integer, OPTIONAL): Number of revisions to return. Range 1-100. Default 10. RESPONSE CONTRACT: - entries: Newest-first revisions; always present. Each entry includes rev, file_id, name, path_display, size, server_modified, client_modified, mime_type, and content_hash. - rev is the opaque revision identifier for that file revision. - is_deleted: Whether the latest revision is now deleted or moved away from the requested path. - server_deleted: Deletion or move-away timestamp when is_deleted=true. - has_more: Upstream has more history. before_rev pagination is not exposed; raise limit up to 100 instead. ASSISTANT POLICY: - This tool is read-only. Use it to inspect revision history. ERRORS (tool-level error_code values): - INVALID_REQUEST: request is nil or malformed. - MISSING_PATH_OR_FILE_ID: path_or_file_id is empty. - INVALID_PATH: path_or_file_id is a malformed fq_path/ns_path or another unsupported identifier form. - INVALID_FILE_ID: path_or_file_id uses a malformed file_id. - INVALID_LIMIT: limit is outside 1-100. - FILE_NOT_FOUND: Dropbox could not locate the requested file. - PATH_NOT_FILE: path_or_file_id resolves to something other than a file. - RESTRICTED_CONTENT, UNSUPPORTED_CONTENT_TYPE, or FILE_LOCKED: Dropbox cannot return revisions for the target because of content restrictions, unsupported content type, or lock state. - PERMISSION_DENIED: no read access to the target. - RATE_LIMIT_EXCEEDED, RATE_LIMITED, RESOURCE_EXHAUSTED, DEADLINE_EXCEEDED, SERVICE_BUSY, or UNAVAILABLE: request was rate-limited, timed out, or hit a temporarily unavailable dependency. EXAMPLES: {"path_or_file_id": "/Documents/report.pdf"} {"path_or_file_id": "ns:123//Documents/report.pdf", "limit": 25} {"path_or_file_id": "id:AbCd-_12"}
list_folder
ChatGPTTool Name: dropbox.list_folder Purpose: List files and folders in Dropbox with cursor-based pagination. Supports recursive (default) and children-only modes. PATHS (SUPER IMPORTANT): - Input path accepts fq_path (for example "/Documents") or ns_path (for example "ns:123//Documents"). - Paths are case-insensitive. - Use "" or "/" for root. - Output entries[].path is always ns_path. Use this exact value for follow-on MCP calls. - Output entries[].file_id can be reused as "id:<file_id>" in follow-on MCP calls. - Output entries[].path_display is the fq_path. Only populated when max_depth=1 (children mode). Empty for recursive mode (max_depth=0). - Never strip the "ns:<id>//" prefix from returned paths. REQUEST MODES: - First call: send {"path": "..."} with optional parameters. To list root, send {"path": ""} or {"path": "/"}. Do not include cursor. - Pagination: send {"cursor": "..."} only. Do not include path or other parameters. - Cursor pagination returns the listing state from when the list started, not the latest folder state. To observe renames, moves, or new children after the first page, start a new list request instead of continuing the old cursor. - WARNING: Omitting max_depth means recursive mode (max_depth=0). Recursive mode may traverse deeply and across mounted namespaces. For browsing folders or showing a user what is inside a folder, set max_depth=1 explicitly unless the user asked for a recursive scan. PARAMETERS: - path (string, REQUIRED, first call only): Directory to list. Accepts fq_path or ns_path. Use "" or "/" for root. Do not omit path in client requests, even though the backend may tolerate omission. - cursor (string, pagination only): Cursor from a previous list_folder response. Mutually exclusive with all other parameters. - object_types (string[], optional, first call only): User-facing object type filters. Valid values: "folder", "file". Empty or omitted returns all supported entries. - "folder" includes regular folders and shared/team folder mounts. - "file" includes regular files and cloud docs. - For extension/category filtering, use search with path + file_extensions/file_categories. - max_depth (uint32, optional, first call only): 0 (default) lists all descendants recursively. 1 lists immediate children only (like ls). - max_results (uint64, optional, first call only): Maximum page size. Range 0-600. 0 or omitted uses the default (300). It may return fewer entries than requested, including zero entries, even when has_more=true. RESPONSE CONTRACT: - entries[]: Array of object records. - name: Basename only. - path: ns_path. Use this exact value for follow-on MCP calls. - modified_time: ISO 8601 when available. - file_id: Encoded object id. Can be reused as "id:<file_id>". - object_type: "file" | "folder" | "mount". - path_display: fq_path. Populated for max_depth=1 only. Empty for recursive mode. - file.size: Present when object_type="file". - folder: Empty object when object_type="folder". - mount: Empty object when object_type="mount". - Shared folders may surface as object_type "mount" after sharing. - cursor: Opaque cursor for the next page. Empty when has_more=false. - has_more: Whether more results remain. - Page size is variable. It may return fewer entries than requested, including zero entries, even when has_more=true. Do not infer completeness from entry count alone; always check has_more. ASSISTANT POLICY: - When showing entries to the user, MUST use path_display if path_display is present. Only fall back to path (ns_path) when path_display is absent or empty. - For interactive folder browsing, prefer max_depth=1. Use recursive max_depth=0 only when the user explicitly asks to scan descendants. - Validate modes strictly: first call uses path, pagination uses cursor only. Do not send options with cursor. - Cursor pagination is snapshot-style: continuing a cursor returns the state from when the list started. Start a new list request when the user wants the latest folder state. - Treat results as partial while has_more=true or cursor is non-empty. - Ask before scanning many additional pages for exhaustive requests. - Never claim root-level completeness until pagination is exhausted. - For follow-on MCP calls, always reuse entries[].path or "id:<file_id>" exactly as returned. EXAMPLES: {"path": ""} {"path": "/Documents"} {"path": "ns:123//Documents"} {"cursor": "base64_cursor_from_previous_response"}
list_restore_events
ChatGPTTool Name: dropbox.list_restore_events Purpose: Retrieve the history of file and folder activity in a user's Dropbox account. When to use: When the user wants to see what happened to their files - edits, deletions, moves, renames, or restores. Useful for understanding recent changes, auditing activity, or finding files to restore. PARAMETERS: - path (string, optional): Folder path to scope the history to. Accepts "" or "/" for root, fq_path like "/Documents", ns_path like "ns:123//Reports", or file_id. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. Dropbox shared/web URLs are not accepted. File paths are not supported and will return an error. - timestamp (uint64, optional): Starting point in time, in seconds since epoch UTC. Default (0) represents current time when direction=PAST and beginning of time when direction=FUTURE. - direction (string, optional): Time direction to traverse: "PAST" (default, shows recent events going backwards in time) or "FUTURE" (shows events going forward from timestamp). - cursor (string, optional): Pagination cursor from previous response to fetch the next page of results. - only_rewindable (bool, optional): If true, only return events that the user has permission to revert/restore. RESPONSE CONTRACT: - events: List of file activity events, each containing: - actor: Information about who performed the action (display_name, photo_url, type) - op_type: Operation type (e.g., "EDIT", "DELETE", "RESTORE", "MOVE", "ADD", "RENAME") - timestamp: Time of event in microseconds since epoch UTC - Event-specific metadata (only one will be populated): - edit_metadata: For EDIT operations (containing_path_display, name) - move_metadata: For MOVE operations (from_containing_path_display, to_containing_path_display, name, is_dir) - move_out_metadata: For MOVE_OUT operations (from_containing_path_display, name, is_dir) - move_in_metadata: For MOVE_IN operations (to_containing_path_display, name, is_dir) - rename_metadata: For RENAME operations (containing_path_display, from_name, to_name, is_dir) - single_object_metadata: For ADD, DELETE, RESTORE, and sharing operations (containing_path_display, name, is_dir) - multi_object_metadata: For operations on multiple objects (containing_path_display, file_count, folder_count) - rollback_metadata: For ROLLBACK operations (containing_path_display, to_timestamp, name) - has_more: Whether there are more events to fetch - cursor: Continuation cursor for pagination ASSISTANT POLICY: - Use this tool when the user asks about file history, recent changes, "what happened to my file", or wants to restore deleted/modified files. - Display events in a human-readable format with who did what, when, and to which files. - For large histories, use pagination with the cursor to fetch additional events. - Event timestamps are in microseconds since epoch UTC; convert them to readable dates for the user. - This tool only lists history. For a follow-up restore, call restore_folder with the live containing folder and a target timestamp immediately before the unwanted event. - only_rewindable=true filters the event list; restore_folder remains authoritative for restore eligibility and errors. ERROR CASES: - INVALID_PATH: The provided path is invalid, cannot be resolved, or points to a file (only folders are supported). - INVALID_CURSOR: cursor was combined with other parameters, or is malformed/expired. When paginating, send only the cursor. - INVALID_DIRECTION: direction was not "PAST" or "FUTURE". - PERMISSION_DENIED / ACCESS_ERROR: The user does not have permission to view events in this location. - RATE_LIMIT_EXCEEDED: Request exceeded tool rate limits. EXAMPLES: {"path": "/Documents", "direction": "PAST"} {"path": "ns:123//Reports", "timestamp": 1640000000, "only_rewindable": true} {"path": "id:AbCd-_12"} {"cursor": "opaque_cursor_abc123"}
list_shared_links
ChatGPTTool Name: dropbox.list_shared_links Purpose: List shared links owned by the authenticated user, optionally filtered to a specific path. When to use: When the user wants to see what shared links exist for their files/folders, check if a file already has a shared link, or review their sharing activity. PATHS: - Input path accepts fq_path, ns_path, or file_id. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive. - If no path is provided, or path is "" or "/", returns all shared links for the user. - Never strip the "ns:<id>//" prefix from returned paths. REQUEST MODES: - First call: optionally send path. - Pagination: send cursor only. Do not include path. PARAMETERS: - path (string, optional): File or folder to list links for. Omit path to list all shared links. Only returns links directly on the specified path (no parent folder links). - cursor (string, pagination only): Opaque non-empty cursor from a previous list_shared_links response. Reuse only with list_shared_links pagination. Mutually exclusive with path. RESPONSE CONTRACT: - links[]: Array of shared link entries. - url: The shared link URL. - link_type: "file", "folder", or "other". - name: Name of the linked file or folder. - path_lower: Lowercased path in the user's Dropbox. May be empty if the link is not in the authenticated user's Dropbox. - audience: Effective audience - "public", "team", or "no_one". - access_level: "view" or "edit". - expires: Expiration in RFC 3339 format. Empty if no expiration set. - allow_download: Whether download is allowed via this link. - password_protected: Whether the link requires a password. - has_more: Whether the server has more pages to scan. has_more=true means there is more data to scan but does not guarantee additional matching links; a page may return zero links with has_more=true. has_more=false means scanning is complete. Always paginate until has_more=false; do not infer completeness from link count alone. - cursor: Opaque cursor for the next page. Empty when has_more=false. ASSISTANT POLICY: - If cursor is set, send cursor only and drop all other fields. - Treat results as partial while has_more=true. - Ask before scanning many additional pages. - Do NOT automatically call create_shared_link after listing. Only create new links when explicitly asked. ERROR CASES: - PATH_NOT_FOUND: The specified path does not exist. - INVALID_CURSOR: The cursor is invalid or expired. Start a new listing. - PERMISSION_DENIED: No access to list links for this content. - RATE_LIMIT_EXCEEDED: Request exceeded tool rate limits. EXAMPLES: {"path": "/Documents/report.pdf"} {"path": "/Documents"} {"path": "id:AbCd-_12"} {} {"cursor": "base64_cursor_from_previous_response"}
move
ChatGPTTool Name: dropbox.move Purpose: Move one or more files/folders in Dropbox as a single batch. When to use: Any time the user asks to relocate, rename, or reorganize files and folders. Prefer move over a delete+create dance. PATHS: - Each entry's source_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt". - destination_path accepts fq_path, ns_path, file_id, or file_id with an appended child path such as "id:AbCd-_12/name.txt"; Dropbox resolves lookup, conflicts, and destination semantics. - Namespace IDs in ns_path are decimal digits and match [0-9]+. - file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. - Dropbox shared/web URLs are not accepted. - Paths must be Unicode NFC-normalized; decomposed forms are rejected. - Dropbox may create missing destination parent folders during the move; no need to pre-create parent folders unless the user explicitly asks. - Paths are case-insensitive; the same entry can cross between fq_path, ns_path, and file_id forms if needed. - Successful entries may return object.path as ns_path and object.path_display as fq_path. Prefer object.path_display when present and non-empty, both when showing paths to the user and in follow-on tool calls. If path_display is absent or empty, fall back to object.path or object.file_id exactly as returned. - Never strip the "ns:<id>//" prefix from returned ns_path values. REQUEST CONTRACT: - entries (required, 1..1000): list of { source_path, destination_path } pairs. - autorename (optional, default false): when true, Dropbox renames the destination to avoid a conflict instead of failing that entry. RESPONSE CONTRACT (flat lifecycle fields, MIRROR of copy/delete): When status is "completed": - status: "completed" - result_type: "move" - move_result.entries[]: per-entry records in request order. - entry_index: 0-based index into the original entries list. - entry_status: "success" or "failed". - object (on success): { name, file_id, object_type: "file"|"folder", path_display, file.size when file, modified_time }. - failure (on failure): { error_code, message }. When status is "in_progress": - status: "in_progress" - operation_id: opaque token to pass to dropbox.check_job_status. - recommended_poll_after_ms: suggested delay before the next check_job_status call. Job-level failures are returned as tool errors. Per-entry failures are returned in move_result.entries[] when status is "completed". ERRORS (job-level): - INVALID_REQUEST: entries is empty, nil, or malformed - INVALID_ENTRY: an entries item is missing source_path or destination_path - INVALID_PATH: source_path is not a valid fq_path/ns_path/file_id value, or destination_path is not a valid fq_path/ns_path/file_id value - TOO_MANY_ENTRIES: more than 1000 entries submitted in one call - INVALID_ARGUMENT: Dropbox rejected the batch as malformed ERRORS (per-entry error_code values): - Source lookup failures use from_lookup/ codes, such as from_lookup/not_found, malformed paths, non-file/non-folder targets, restricted content, unsupported content type, or locked content. - Source write failures use from_write/ codes for conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Destination write failures use to/* codes for destination conflicts, malformed paths, missing write permission, space/quota issues, disallowed names, team-folder constraints, suppressed operations, too many write operations, or access restrictions. - Move-specific constraints include cant_move_folder_into_itself, cant_move_shared_folder, cant_move_into_vault, and cant_move_into_family. - Batch, sharing, permission/quota, and temporary failures include duplicated_or_nested_paths, too_many_files, cant_copy_shared_folder, cant_nest_shared_folder, cant_transfer_ownership, insufficient_quota, too_many_write_operations, and internal_error. - unknown_error means server returned an error variant this tool does not recognize. DUPLICATE DESTINATION QUIRK: - For duplicate destinations in one batch, later entries may report from_write/conflict even though the practical cause is a destination collision. Report it to the user as a destination conflict. RETRY GUIDANCE: - If status is "in_progress", call dropbox.check_job_status with the returned operation_id. - Do NOT retry the entire batch on per-entry failures; report the specific failures to the user. - too_many_write_operations and internal_error are transient — retry after a short delay if appropriate. EXAMPLES: {"entries": [{"source_path": "/Docs/old.txt", "destination_path": "/Docs/new.txt"}]} {"entries": [{"source_path": "ns:123//A.txt", "destination_path": "ns:123//Archive/A.txt"}], "autorename": true} {"entries": [{"source_path": "id:AbCd-_12", "destination_path": "/Inbox/renamed.pdf"}]} {"entries": [{"source_path": "/Docs/old.txt", "destination_path": "id:AbCd-_12/new.txt"}]} ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided.
paper_apply_markdown
ChatGPTApply an explicit complete Paper title/body state with three-way merge. Use for a new document body, major rewrite, or restructuring. Prefer paper_edit_content or paper_edit_table for small surgical edits, active comment anchors, task metadata, or partial table changes. Workflow: call paper_read_document, build the desired complete body, then call once with its revision. doc_ref: file ID, pad ID, or Dropbox URL. base_revision: required revision returned by paper_read_document. body_markdown: complete desired body only; do not prepend the Paper title. Empty clears the body. A leading H1 remains a body heading. Use real newlines. title: desired title when changing it; empty preserves the current title. Supported Markdown includes headings, bullets, numbered items, tasks, tracked tasks, decisions, quotes, fenced code, tables, and common inline formatting. Dropbox Paper Formatting Paper makes each empty Markdown line a visible blank block; adjacent prose has no margin. User templates, explicit styling, and deliberate existing formatting win. Repair accepted documents locally. One source line per prose paragraph; let Paper wrap and split paragraphs longer than about four rendered lines. Put exactly one blank between prose paragraphs, none doubled or trailing. Keep compact metadata lines consecutive. Set the document title in its field; do not repeat it as a body H1. Use H1, H2, and H3 for main sections, subsections, and deeper sections according to the document outline. Add one blank before headings after prose/lists, none after preamble/heading/table/divider, and none after headings. Colon lead-ins touch lists; list items are consecutive and single-line unless nested. One blank follows a list before prose/heading. All-bold standalone lines become H3; write **Next steps**: (colon outside bold) for a bold prose label. Tables: short header labels, preferably two or three columns, no adjacent blanks. A separator row (| --- | --- |) immediately after the first row sets a native top header; omit it for a table without a header. Reads preserve the separator when a header exists. Bold labels alone do not set a header. Remove the separator, not row 0, to remove header styling while retaining all cell content. Dividers mark major mode changes only, usually zero to two, without adjacent blanks. After writing, re-read canonical revision and structural spacing; inspect live Paper when available, report limits, and repair only affected blocks. Do not depend on CSS pixels/colors. Check prose-to-prose, heading-to-body, colon-to-list, list-to-prose, table header, divider, and document end in the live surface. Without it, do not claim rendered spacing. Mentions in body_markdown use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Mentions are ignored inside inline/fenced code and link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the whole apply with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. The title is always plain text: @<...> in title is stored literally. Returns new_revision, canonical merged body_markdown/title, doc_id, diff, and any conflicts. After success, replace local state with the returned canonical state; it includes non-overlapping concurrent human edits. Re-read with paper_read_document to verify the new revision, content, and formatting. Concurrency: non-overlapping edits merge. Overlapping edits fail without applying changes; re-read and rebuild from the new state. Limitations on changed lines: - Comment anchors can be destroyed. - Tables are atomic; a cell change replaces the table and can overwrite concurrent cell edits. - Markdown cannot faithfully represent every Paper embed,…
paper_create_document
ChatGPTCreate a new empty Paper document. Use when the user asks for a new Paper doc. Do not use to edit an existing doc. title: required document title. Do not duplicate it as an H1 when adding the body; follow the Dropbox Paper Formatting guidance in paper_read_document. dir_path: optional folder path within the user's personal Dropbox. For users on a team, this may be either a home-relative path such as /Paper Docs or an account-root path through the mounted personal folder, such as /John Doe/Paper Docs. Team-space folders are not supported. Omit unless the user requested a location. Returns doc_id, URL, and file_path. Call paper_read_document with doc_id before adding content so later writes use current receipts. Failures leave no usable document result; do not invent an ID.
paper_edit_content
ChatGPTAtomically edit Paper title and non-table body content. One call may update lines, delete lines, replace exact text, and update the title. Use for surgical or mixed edits. Do not use for table cells/dimensions, inserting new blocks, or bulk document restructuring. Precondition: call paper_read_document for current addresses and receipts. Follow its Dropbox Paper Formatting guidance; preserve deliberate existing formatting and make local repairs. At least one operation is required. All operations succeed in one revision or none apply. update_lines[] targets an existing line with section_id, zero-based section_line, and line receipt. markdown is the complete replacement line. Markdown prefixes can change paragraph/heading/list/task type. Code-block type is preserved. Use completed or uncompleted for task state; do not set both. Tracked tasks additionally accept due_date, assignees (including "me"), clear_due_date, and clear_assignees. Mentions in update_lines[].markdown and find_and_replace[].replace use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Tracked-task assignees[] accepts the same bare user_ref forms without @<...> wrapping. Mentions are ignored inside inline/fenced code and link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the entire edit with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. update_title.text is always plain text, so @<...> is stored literally there. delete_lines[] targets lines with section_id, section_line, and line receipt. The server safely orders deletions. Never target readonly or synthetic terminal lines. find_and_replace[] performs document-wide exact visible-text replacements. search must be non-empty. Use when the intended match is unambiguous; otherwise use addressed line updates. Multiple replacements run in request order inside the same atomic mutation. update_title is present only when changing the title: - text is the new title; empty text clears it. - receipt is title_receipt from paper_read_document. Line-update rules: - Plain text demotes promotable lines to paragraphs; prefixes promote supported types. - Tracked tasks, decisions, and tables cannot be converted through a line update. - Replacing a table line cannot change its dimensions; use paper_edit_table. - Heading edits can change section structure, so re-read afterward. Conflicting/overlapping operations in the same request are rejected rather than ordered ambiguously. Stale receipts or any invalid target fail the entire batch with no changes. Returns new_revision and a combined diff. Show it to the user. Re-read after every successful content mutation to verify its revision and formatting, and after stale errors before retrying.
paper_edit_table
ChatGPTAtomically edit one existing Paper table. One call may update cells and add, delete, or move rows and columns. Use instead of reconstructing table Markdown. Do not target multiple tables or non-table lines. Paper Markdown represents a native top header with a separator row (| --- | --- |) immediately after the first row; without the separator, the table has no header. Reads preserve this state. Bold first-row labels alone do not set a native header. paper_edit_table preserves the header state and has no header-toggle field; use paper_apply_markdown to add or remove the separator. The separator is not a cell row and does not count toward row indices. Do not delete row 0 to remove header styling while retaining its content. Markdown does not expose a separate sticky-header setting; verify live behavior before claiming it. Precondition: call paper_read_document. Follow its Dropbox Paper Formatting guidance for tables; preserve deliberate existing structure and formatting. Set doc_ref, the table line's section_id/zero-based section_line, and its line receipt. At least one operation is required. update_cells[]: 0-based row/col plus complete cell Markdown. Empty clears a cell. Supports inline formatting, links, images, and multi-line cell content. Do not use horizontal-rule syntax as a structured cell type. Mentions in update_cells[].markdown and add_rows[]/add_columns[] cells use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Mentions are ignored inside inline/fenced code and link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the whole table edit with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. add_rows[]: after_position is the 0-based row to insert after; cells must match the current column count. add_columns[]: after_position is the 0-based column to insert after; cells must match the current row count. delete_rows[] / delete_columns[]: position is the 0-based index. move_rows[] / move_columns[]: from_position and to_position are 0-based indices. Operations execute in listed field order against one atomic plan: 1. cell updates 2. row additions 3. column additions 4. row deletions 5. column deletions 6. row moves 7. column moves Indices for later operations refer to the table state after earlier operations. Prefer one coherent request and avoid targeting a row/column both before and after its deletion. Any stale receipt, invalid index, duplicate cell, dimension mismatch, or conflicting operation rejects the entire batch with no changes. Returns new_revision and a whole-table diff. Show it to the user, then re-read to verify the new revision, table structure, and formatting before another table edit; dimensions/indices may have changed.
paper_get_doc_history
ChatGPTGet Paper document history with authors and diffs. Use it to answer what changed, how a document’s themes evolved, or who contributed to a change. Do not use it to read the current document structure or obtain edit receipts. doc_ref accepts a file ID, pad ID, or Dropbox URL. since accepts rev:1042, a relative duration such as -3h/-7d/-30m, or an RFC 3339 timestamp. Empty since keeps its existing seven-day default. Leave grouped=false (the default) for the aggregate author-annotated diff over that time window. Set grouped=true to return the Paper UI edit sessions in chronological revision order. Use limit to request up to 20 sessions (0 defaults to 20). For the first grouped page, omit after_revision; for every later page, repeat the same since and set after_revision to the prior next_after_revision. Stop when next_after_revision is 0. For example: call with since="-7d", grouped=true, limit=20; then call again with those values plus the returned next_after_revision. Returns canonical doc_id, revision bounds, and either aggregate authors plus diff, or per-session history_entries with author-annotated diffs. This is evidence, not a mutation receipt. Use paper_read_document for current addresses and receipts. Invalid since, after_revision, or limit fails without changing the document. Aggregate history is limited to 10,000 revisions in the requested time range. Grouped history is limited to 10,000 revisions in each returned page. If the limit is exceeded, the error includes the revision count and limit; retry with a shorter time range or, for grouped history, a smaller limit.
paper_insert
ChatGPTInsert one or more new Paper lines without replacing existing content. Use exactly one placement: in_section, after_line, or at_document_end. Do not use for images or modifying existing lines. Precondition: call paper_read_document and use current addresses/receipts. doc_ref: prefer returned doc_id. lines[].markdown: each item is one logical Paper block. A fenced code block or complete pipe-delimited table must be one item and may contain newlines. Mentions in lines[].markdown use @<user_ref>, where user_ref is "me", a decimal Dropbox user ID, a dbid, or an exact email. Use \@<...> for literal text; bare @name remains plain text. Mentions are not parsed inside inline/fenced code or link destinations. A target must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. Mentioning never provisions a user or grants access. Unknown, inactive, ambiguous, and ineligible refs all reject the whole insert with the same non-identifying error. Verify the exact email or user ID; if the intended user is not already a collaborator, ask the user to share the document first. Placements: - in_section: section_id and section receipt. Default appends to the section body; at_start=true inserts immediately after its heading. Use section_id="preamble" with at_start=true for the document top. - after_line: section_id, zero-based section_line, and section receipt. Inserts after that line. - at_document_end: receipt of the final section from paper_read_document. Markdown prefixes auto-promote headings, lists, tasks, quotes, code blocks, tables, and horizontal rules. Follow the Dropbox Paper Formatting guidance in paper_read_document, including the spacing at the insertion boundaries. All lines insert atomically in one revision. Returns new_revision and diff. Show the diff to the user. Failure behavior: - Supplying zero or multiple placements is invalid. - Empty lines is invalid. - A stale receipt fails without applying the insert; re-read and retry. - After success, re-read to verify the new revision, inserted content, and formatting before another addressed edit; line positions may shift.
paper_insert_image
ChatGPTUpload image bytes and insert the image into a Paper section. Use for local/generated image data. Do not use for Markdown text or an already-hosted Markdown image URL. Precondition: call paper_read_document. doc_ref: prefer returned doc_id. data: base64-encoded image bytes only. filename: filename with a correct image extension. section_id and receipt: section and current section receipt from the read. section_line: zero-based line after which to insert; 0 inserts after a non-preamble heading. alt_text: concise accessible description. Returns new_revision, hosted URL, and diff. Show the diff to the user. On stale receipt, re-read and retry. Do not blindly retry an unknown upload outcome.
paper_list_recent_docs
ChatGPTList the caller's recently active Paper documents. Use to discover a doc when its ID or link is unknown. Do not use for full-text search or reading contents. edited_only=true returns docs recently added or edited. viewed_only=true returns docs recently viewed. Leave both false for both activity types. They are mutually exclusive. limit is 1-50; 0 defaults to 20. Returns docs in activity order with doc_id, title, timestamp, and relative time. Pass doc_id to paper_read_document. Deleted/unresolvable docs may be omitted.
paper_read_document
ChatGPTRead a Paper document. Call before addressed edits, comments, or when current content matters. Returns canonical identity, revision, sections, editable lines, receipts, and threads. doc_ref accepts a Dropbox file ID ("id:..."), Paper pad ID, or Dropbox URL. Prefer the returned doc_id in later calls. only_sections=true returns document/section metadata without bodies or threads; use for low-token structure discovery. section_ids returns bodies and threads only for the named sections while still returning the full section index. Unknown IDs fail. Do not combine section_ids with only_sections. Returns: - revision: use as paper_apply_markdown.base_revision. - title and title_receipt. - sections[] with id, display_path, receipt. Section receipts authorize section inserts and resolving threads. - users[] is one unique, document-level identity directory for users referenced by the stored body, comments, or tracked-task metadata. Each entry contains stable user_id plus current email and display_name. Order is unspecified. only_sections=true omits users; section_ids filtering still returns the whole document directory. - Mentions in body, table, and comment text are always returned as @<user_id>. Look up user_id in users[] for current display details. Tracked-task lines keep their association in tracked_task.assignees. Titles are plain text and never expose mentions. The stable text form prevents an email or display-name change from changing document meaning. users[] is safe from enumeration because it is derived only from mentions already embedded in a document the caller can read; it is not a people-search result. Write eligibility requires existing explicit document access when a reference is created. A stored reference remains readable if document access changes later. - section_lines[] with section_id, zero-based section_line, markdown, receipt, readonly. Do not mutate readonly lines. - threads[] with comment/thread IDs and anchor locations. Addressing: - A non-preamble section has its heading at section_line=0 and body at 1+. - The always-present preamble has no heading and starts at 0. - Receipts are opaque and scoped to the object returned. Never invent or reuse a stale receipt. After inserts/deletes, re-read before further position-based edits in that section. Choose the narrowest tool: - paper_apply_markdown: complete-body creation, major rewrite, or restructuring. It is bulk and may replace rich constructs on changed lines. - paper_insert: add text at a section start/end, after a line, or at document end. - paper_insert_image: upload and insert image bytes. - paper_edit_content: atomically update/delete lines, replace exact text, or update the title. - paper_edit_table: atomically update cells or add/delete/move rows and columns in one table. - paper_comment: add, reply to, or resolve a comment thread. - paper_get_doc_history: inspect authors and changes over time. - paper_list_recent_docs: discover recent Paper docs. - paper_create_document: create an empty Paper doc. Paper Markdown: - Blocks: headings (#/##/###), bullets (-), numbered items (1.), tasks (- [ ]), tracked tasks (- ( )), decisions (- { }), quotes (>), fenced code blocks, and pipe-delimited tables. Mentions: - In paper_apply_markdown body_markdown, paper_insert lines, paper_edit_content body destinations, paper_edit_table Markdown cells, and comment/reply text, create a mention with @<user_ref>. user_ref may be me, a decimal Dropbox user ID, dbid:..., or an exact email address. Use \@<...> for literal text. - Marked mentions are ignored inside code spans, fenced code blocks, and link destinations. Bare @name remains plain text. - Tracked-task assignees accept the same bare user_ref forms without @<...> wrapping. - A ref must resolve to exactly one active account that already has explicit document access; organization membership alone is not sufficient. This also handles an email attached to multiple teams: exactly one eligible account must remain. - Mentioning never provisions a user or grants document access. Unknown, inactive, ambiguous, and ineligible …
restore_file_revision
ChatGPTTool Name: dropbox.restore_file_revision Purpose: Write the contents of a prior revision identified by rev to destination_path. The destination receives a new file revision containing those prior contents. PATHS: - destination_path accepts fq_path (for example "/Documents/file.txt") or ns_path (for example "ns:123//Documents/file.txt"). file_id is NOT accepted. - Dropbox shared/web URLs are not accepted. - Paths are case-insensitive. - destination_path and rev must be in the same namespace. - Never strip the "ns:<id>//" prefix from returned paths. WRITE WARNING: - This tool upserts the rev's contents to destination_path. It is not limited to the file the rev originally came from. - If destination_path does not exist, restore creates a new file there from the rev's contents. - If destination_path already exists, restore overwrites that file's content, even when it is an unrelated file. - Any valid rev can be written to any writable destination_path in the same namespace. There is no guard that checks whether the rev belongs to the destination file. - Restoring a deleted file's last rev to its old path can resurrect that file. REQUEST CONTRACT: - destination_path (string, REQUIRED): Destination path where the prior revision's contents will be written. - rev (string, REQUIRED): Revision hash to restore. Obtain from a prior list_file_revisions or get_file_metadata response. RESPONSE CONTRACT: - file: object describing the file at destination_path after the restore. - name, path, modified_time, file_id - object_type: "file" - file.size: File size in bytes. - path_display: fq_path for human display when populated. - rev: Revision hash of the current/returned state of the file. This is a new rev distinct from the rev that was restored. - Prefer path_display when present and non-empty, both when showing the returned file to the user and in follow-on MCP calls. If path_display is absent or empty, fall back to path (ns_path). Use file_id only for tools that explicitly accept it; restore_file_revision does not. ASSISTANT POLICY: - Before calling this tool, the assistant MUST summarize the exact mutation plan and get explicit user confirmation in chat. - The assistant MUST NOT claim the mutation already happened until the tool returns a successful response. - After a successful response, the assistant MUST clearly list exactly what changed, using returned paths, file_id values, status values, and URLs when available. - If the response represents partial success, the assistant MUST separate the succeeded and failed parts explicitly. When both shared_with and share_errors are present, report each list separately. - After a successful response, the assistant MUST tell the user how to revert the change. - For created files or folders, tell the user you can revert by calling dropbox.delete on the returned path_display after separate explicit confirmation. - For deleted files or folders, tell the user they can restore deleted content and include https://help.dropbox.com/delete-restore/recover-deleted-files-folders. - When recovering an older file version is relevant, include https://help.dropbox.com/delete-restore/recover-older-versions. - For sharing changes, instruct the user to manage or revoke sharing from the Dropbox web UI and include https://help.dropbox.com/share/unshare-folder. - Dropbox path handling: path_display is the preferred path. Always use path_display when it is present and non-empty, both in user-facing output and in follow-on tool calls. If path_display is absent or empty, fall back to the returned path/file_id exactly as provided. ERRORS: - INVALID_REQUEST / MISSING_PATH / MISSING_REV: input validation - INVALID_PATH: destination_path is malformed - FILE_NOT_FOUND / PATH_NOT_FOUND: backend could not locate a required path while preparing the restore. A valid nonexistent destination_path may still be creatable. - INVALID_REVISION: rev is unknown, outside the restorable window, or in a different namespace from destination_path - PERMISSION_DENIED: no write access to destination_path - RESTORE_IN_PROGRESS: restore was accepted, but the restoration work needs more time than this tool monitors for. The restore may still complete after this error. - FILE_LOCKED: destination file is locked RETRY GUIDANCE: - On RESTORE_IN_PROGRESS, do not assume failure. Wait briefly, check destination_path metadata or contents if possible, and retry with the same arguments only if the destination still is not restored. - Do NOT retry on INVALID_REVISION; the rev is not restorable. EXAMPLES: {"destination_path": "/Documents/report.pdf", "rev": "a1c10ce0dd78"} {"destination_path": "ns:123//Projects/image.png", "rev": "0123456789ab"}
restore_folder
ChatGPTTool Name: dropbox.restore_folder Purpose: Restore a folder to a previous state by rewinding all changes back to a specific point in time. When to use: When the user wants to undo changes to a folder and restore it to how it looked at an earlier time. This is useful for recovering from accidental deletions, unwanted edits, or reverting to a known-good state. PARAMETERS: - path (string, required): Path to the folder to restore. Accepts fq_path, ns_path, or file_id. file_id: a Dropbox-issued file id (format: "id:<id>", where <id> uses A-Z, a-z, 0-9, "_" and "-"; example: "id:AbCd-_12"). It can identify a file or folder. Dropbox shared/web URLs are not accepted. - target_ts_microseconds (uint64, required): Target timestamp to restore to, in microseconds since epoch UTC. The folder will be rewound to this point in time. - is_team (boolean, optional): Whether this is a team restore. Defaults to false. When false, affects individual and shared folder content but not team-owned content. When true, affects team-owned content. RESPONSE CONTRACT: - operation_id: Signed operation token for this restore operation. Pass this to check_job_status to poll for completion. This is an encrypted, signed token containing the restore job ID and user binding. ASSISTANT POLICY: - Use this tool when the user wants to restore a folder to a previous state or undo recent changes. - Ask the user to confirm before proceeding - folder restores are significant operations. - Convert human-readable dates/times to microseconds since epoch UTC when constructing target_ts_microseconds. - Explain that the restore is asynchronous and returns immediately with an operation ID. - After calling this tool, use check_job_status with the returned operation_id to poll for completion. - Pass operation_id unchanged. On INVALID_OPERATION_ID, do not re-poll with the same token; start a new restore operation only if the user still wants the restore. - On completion, report restore_folder_result, including the restored path and file/folder counts. - For team restores, set is_team=true only when explicitly requested and the user has appropriate permissions. - To recover a deleted child, restore its live containing folder to a timestamp immediately before the deletion. Do not target the deleted path itself. - Apply ACCOUNT ELIGIBILITY and ERROR CASES below before retrying or suggesting an alternate restore scope. IMPORTANT NOTES: - This operation is asynchronous. The API returns immediately with an operation ID, but the actual restore happens in the background. - Use check_job_status to poll for completion status. - Folder restores affect all content within the folder, including subfolders. - Team restores require appropriate team admin permissions. ACCOUNT ELIGIBILITY (who can restore, and from where): - Eligible paid personal accounts: "/" can rewind the whole account scope, while a specific live folder limits the restore to that folder tree. - Plans without Rewind: the tool returns REWIND_NOT_SUPPORTED_BY_PLAN. This means the plan does not support Rewind, not that the actor lacks permission. There is no path or argument change that makes the restore succeed; see https://help.dropbox.com/delete-restore/rewind for currently eligible plans. - Team accounts: "/" is the team member root and is never a valid restore target; it returns TEAM_MEMBER_ROOT_NOT_RESTORABLE before RewindsStart. Target a specific writable folder instead. Rewind availability is also controlled by team policy and is admin-only by default unless an admin enables it for members. Team-owned content restores require is_team=true, edit access to the team folder, and the required team permission. - These outcomes are plan/scope policy, not transient errors. Do not retry; surface the explanation to the user. ERROR CASES: - PATH_REQUIRED: No path was provided. - TARGET_TIMESTAMP_REQUIRED: No target timestamp was provided. - INVALID_PATH: The provided path is invalid or cannot be resolved. Note: a DELETED child folder path resolves to INVALID_PATH (the live object no longer exists); restore the live PARENT folder to recover deleted children instead of targeting the deleted child directly. - PATH_NOT_FOLDER: The provided path points to a file instead of a folder. - PATH_DELETED: The provided path points to a deleted object. - TEAM_MEMBER_ROOT_NOT_RESTORABLE: The authenticated team member root "/" is not a valid restore target. Choose a specific live folder. Not retryable with the same path. - INSUFFICIENT_PERMISSIONS: The actor does not have permission to restore the requested scope. On a team account, target a specific writable folder or ask a team admin to enable Rewind for members. Not retryable with the same path and permissions. - REWIND_NOT_SUPPORTED_BY_PLAN: Folder restore (Rewind) is not supported by this account plan. See https://help.dropbox.com/delete-restore/rewind. Not retryable. - INVALID_ARGUMENTS: The restore request arguments were rejected by the backend (bad path, timestamp, or namespace scope). - INVALID_OPERATION_ID: check_job_status rejected the operation token because it is missing, malformed, expired, issued to a different user, or invalid for the Rewind status endpoint. Not retryable with the same token. - RATE_LIMIT_EXCEEDED: Request exceeded tool rate limits. EXAMPLES: {"path": "/Documents/Projects", "target_ts_microseconds": 1640000000000000} {"path": "ns:123//Reports", "target_ts_microseconds": 1640000000000000} {"path": "id:AbCd-_12", "target_ts_microseconds": 1640000000000000, "is_team": true}
search
ChatGPTSearch Dropbox files with one public tool that supports both simplified and advanced search flows. REQUEST: - New search: query is required. Optional advanced parameters: path, file_extensions, file_categories, max_results, filename_only, order_by, reverse_order, last_modified_after, last_modified_before. - Pagination: cursor only. Do not repeat query or filters when cursor is set. RESPONSE: - results: Unified search results - id: Tool-ready file identifier when a file_id is present (format: "id:<file_id>") - title: File or folder name - url: Openable Dropbox URL supplied directly by Fileverse search. - path, path_display, object_type, match_type, mime_type, size, last_modified, rank: Additional search result fields when available - has_more, cursor, total_results: Pagination fields populated in advanced/raw mode NOTES: - Plain {"query": "..."} keeps the ChatGPT App simplified flow: up to 20 file results from a single backend search page. - Any extra parameter beyond query, or any cursor call, switches search into advanced/raw mode. - Search may return files that later fail text extraction in fetch.
sign_cancel_signature_request
ChatGPTCancel an in-progress Dropbox Sign signature request. Cancelling prevents any remaining signers from signing the document and cannot be undone. Use this tool only when the user explicitly asks to cancel a signature request. Do not use it to decline or reject a single signer: it cancels the entire request for every party. A request can be cancelled only when it was sent successfully rather than left as a draft, has not been signed by every signer (partially signed requests are eligible), and the authenticated user is its sender or the owner of the API app under which it was sent. If it is ineligible, explain why instead of calling the tool. Identify the request first. When its signature_request_id is unavailable, use sign_list_signature_requests to find it and ask the user to confirm the correct request. If the user is unsure, do not proceed. Before calling sign_cancel_signature_request, present a confirmation summary with the document title and the warning, "This will permanently cancel the signature request and cannot be undone." Do not call the tool until the user explicitly confirms, and call it exactly once. Pass only the required signature_request_id string; do not pass any other parameters. The response is empty on success: tell the user only that the request was cancelled, without offering to undo the action. If the call fails, surface the error in plain language and do not retry automatically.
sign_create_signature_request_draft
ChatGPTCreate an unclaimed draft from an existing Dropbox file, returning a claim_url that logs the user into Dropbox Sign and then redirects them to the unclaimed draft in the Dropbox Sign web app. Use this tool whenever the user wants to send a Dropbox file for signature or sign it themselves. It does not send anything immediately — the user must finish the workflow in the browser. Default to "request_signatures" mode; only use "self_sign" if the user explicitly says they want to sign the document themselves. Before calling, confirm the exact Dropbox file (search for it if not already established in the conversation) and pass its file ID as file_ref, in the form id:<id>. Never invent, reconstruct, truncate, or modify this ID. Determine the mode from context, or ask if it's unclear. Present a confirmation summary first, covering the file name/location and the mode in plain language. For "request_signatures", explain that this will open the Dropbox Sign editor where the user can place fields and send the request. For "self_sign", explain that it will open the editor where the user can place fields and sign the document. Do not include the raw file_ref or any internal path in the summary. Call this tool exactly once per confirmed request; do not call it again once a claim_url is returned. Collect each signer's name and email address if the user wants to add signers now; never invent or infer a name or email address. Signers are optional — if the user doesn't provide any, create the draft without them and they can be added later in the Dropbox Sign editor. Include any provided signers in the confirmation summary, listing each name and email address. The response contains only claim_url. Always present it as a plain URL on its own line — never as a markdown link, and never paraphrased or shortened. Explain that opening it logs the user into Dropbox Sign and then redirects them to the draft, where they can place fields and complete the request; do not describe the request as sent or completed. Only after the call succeeds and you present the claim_url, offer relevant follow-up help in your own words. For "request_signatures", explain that after the user sends the request from the Dropbox Sign editor, they can return to this chat to check its status. Also let them know they can ask to find or download other completed or pending requests, cancel pending requests, or remind pending signers. For "self_sign", explain that after they complete their signature in the editor, they can return to this chat to find the document, check its status, or download it. Do not suggest sending, cancellation, or signer reminders for the self-sign draft. Keep this brief and natural rather than presenting a fixed script or implying that any action has already happened. If the call fails, do not offer this follow-up guidance. If the call fails, surface the error message in plain language, do not present a claim_url, and do not retry automatically. For any unexplained or generic failure, do not present a raw error; tell the user to confirm the file is saved in Dropbox and accessible to them before retrying.
sign_download_signature_request
ChatGPTDownload the current PDF snapshot for a Dropbox Sign signature request, returning a temporary file_url that can be used to fetch the file. Use this tool only when the user asks to download a signature request. Identify the request first with sign_list_signature_requests when its signature_request_id is unavailable. Confirm it is the intended request before calling this tool. Pass only the required signature_request_id; do not pass any other parameters. The response contains only file_url. It is a temporary, presigned URL and a bearer credential for the current PDF snapshot. Treat it as sensitive: share it only with the authenticated user, do not log it, do not include it in summaries or third-party requests, and do not transform, fetch, stream, or base64-encode its contents. Present the URL as a markdown link with clear descriptive text (e.g. [Download signature request](<file_url>)) rather than printing the raw URL, and advise the user that it expires. If the call fails because the request is unavailable, deleted, or the user is not permitted to access it, explain the error in plain language. Do not retry automatically.
sign_list_signature_requests
ChatGPTList and search Dropbox Sign signature requests for the authenticated user. Use this tool when the user wants to find, review, check the state of, or search for signature requests associated with their Dropbox Sign account. This is the primary tool for answering questions like "find my completed requests", "show requests sent to Alice", or "what did I send last month". Do not use it to create, send, cancel, or modify a signature request. PARAMETERS: - max_results (int, optional): Maximum number of results to return, 1-50. Omit when the user has not asked for a particular count. RESPONSE CONTRACT: - signatureRequests[]: Array of signature request objects. - signatureRequestId: Internal ID. Use for follow-up tool calls (cancel, download, remind). Do not display unless the user explicitly needs it. - title: The document title of the signature request. - status: Overall request state. One of: "awaiting_signature", "completed", "declined", "expired". - dateSent: ISO 8601 timestamp when the request was sent. - dateCompleted: ISO 8601 timestamp when all signers completed (empty if not yet completed). - requesterEmailAddress: Email address of the person who sent the request. - signatures[]: Array of signers on this request. - signerName: Signer's display name. - signerEmailAddress: Signer's email address. - statusCode: Per-signer state. One of: "signed", "on_hold", "awaiting_signature", "awaiting_my_signature", "declined", "expired". - order: Signing order position (0-based). ASSISTANT POLICY — Searching and filtering: - When the user asks to find requests sent TO a specific person, match against signatures[].signerEmailAddress and signatures[].signerName (case-insensitive partial match). - When the user asks to find requests FROM a specific person, match against requesterEmailAddress (case-insensitive partial match). Do not claim to filter by requester name. - When the user asks about requests by status (e.g. "completed", "pending", "awaiting signature", "declined", "expired"), match against the status field. Treat "pending" as equivalent to "awaiting_signature". - When the user asks about requests by date or time range (e.g. "last week", "in September"), use dateSent for sent or created ranges and dateCompleted for completion ranges. - When the user asks about requests by title or document name, match against the title field (case-insensitive partial match). - When combining criteria (e.g. "completed requests sent to Alice last month"), apply all filters together. - Present results in a clear summary: title, status, date sent, and signer names. Include dateCompleted for completed requests. - This tool returns at most 50 results. If the result set is at the limit, inform the user that there may be additional matching requests not shown. ASSISTANT POLICY — General: - Do not display signer email addresses or requesterEmailAddress unless the user specifically asks for them or needs to disambiguate between people with similar names. - Treat signatureRequestId as an internal reference for follow-up tools rather than a value to display unless the user explicitly needs it. - Use signer details to show the exact people who would receive a reminder before confirmation. - Only after the tool returns successfully and you present the results, conversationally offer relevant next steps in your own words. Tailor the suggestions to the results and the user's request instead of reciting every option every time: - Download a completed or pending signature request. - Cancel a pending signature request. - Send a reminder to pending signers. - Prepare a new document for signature from a file in the user's Dropbox. To start, the user can identify the Dropbox file and provide each signer's name and email address; signer details can also be added later in the Dropbox Sign editor. - Make it clear that the user can ask for these follow-up actions in the current chat. Do not claim an action has been taken until its corresponding tool has completed successfully. - If the tool returns an error, do not offer these follow-up actions. - If access is denied…
sign_send_signature_request_reminders
ChatGPTSend reminders for a Dropbox Sign signature request. Use this only after the user has selected an incomplete request from sign_list_signature_requests. Before calling, identify the exact recipients who will be contacted and obtain clear confirmation. Do not expose the raw signature_request_id in that confirmation. The tool accepts the internal signature-request ID and an optional email_addresses list of up to 50 unique recipients. When email_addresses is omitted or empty, it determines eligible recipients from the request data fetched before sending. For unordered signing, it sends one reminder to every recipient currently awaiting signature. When email addresses are provided, it sends reminders only to requested recipients who are currently eligible. A requested address that belongs to the request but is not eligible is returned as not_currently_eligible; an address that is not a recipient is returned as recipient_not_found. For ordered signing, only the current eligible signer can be reminded. Other requested recipients are reported as not_currently_eligible, and the response's is_ordered_signing, current_signer_email, and current_signer_name fields identify who can currently be reminded. If the current user is the recipient expected to sign, the tool does not send them a reminder; the result says signature_required. The current signer name falls back to their email address when Sign has no name. The tool never intentionally sends reminders to signed, declined, expired, on-hold, or later ordered recipients. The response's request status is the status observed immediately before sending reminders; the tool does not refresh it afterward. Call this tool exactly once after confirmation. It makes one underlying Sign reminder call per eligible recipient and does not retry. A recipient result of sent confirms that Sign accepted that reminder. rate_limited means Sign indicates the recipient was reminded recently; do not retry automatically. sign_rejected means Sign could no longer send the reminder, and account_unavailable means the connected Sign account cannot send it. failed means the outcome is unknown. signature_required, not_currently_eligible, and recipient_not_found mean no reminder was attempted. Do not retry unsuccessful recipients automatically.
upload_file
ChatGPTTool Name: dropbox.upload_file Purpose: Upload a file from the current conversation to Dropbox. When to use: When the user explicitly asks to save a file (attachment, generated artifact, or file-library selection) to a specific Dropbox destination. BEHAVIOR: - upload_file saves files from the conversation to Dropbox using the ChatGPT openai/fileParams adapter. - Do NOT construct source_file manually; it is always injected by ChatGPT. ASSISTANT POLICY: - Before calling, ensure the source file and exact Dropbox destination are unambiguous. - An explicit user request to upload or save an unambiguous source file to a complete fq_path or ns_path destination (including the filename) counts as explicit user confirmation; do NOT ask for separate confirmation. - If the source file or exact destination is missing or ambiguous, ask the user to clarify before calling. - Do NOT call without an explicit user request. - Do NOT pass free-form URLs, only files provided through the ChatGPT file parameter. - If Dropbox normalization changes the final path, show it and confirm again. PATHS: - Input destination_path accepts fq_path or ns_path. - Namespace IDs in ns_path are decimal digits and match [0-9]+. - file_id and Dropbox shared/web URLs are not accepted as destination. - Paths are case-insensitive. - Parent must exist. This tool does not create missing parent folders. REQUEST CONTRACT: - destination_path (string, REQUIRED): Full Dropbox path including filename. - source_file (object, REQUIRED): File object injected by ChatGPT file parameter. Do NOT construct this manually. RESPONSE CONTRACT: When status is "completed": - status: "completed" - file: object with name, path, modified_time, file_id, object_type, file.size, path_display. - modified_time is the server-side modification time, in ISO 8601 format when available. When status is "in_progress": - status: "in_progress" - operation_id: opaque token for polling via dropbox.check_upload_file_status. ERRORS: - INVALID_PATH: destination path is empty or invalid - INVALID_SOURCE_FILE: source_file is missing, is missing download_url, contains unknown fields, or download_url points at a host not permitted for ChatGPT fileParam uploads - PARENT_NOT_FOUND: parent path doesn't exist - ALREADY_EXISTS: file exists at target path (do NOT retry with same path; ask the user for a different name or location) - PERMISSION_DENIED: no write access - QUOTA_EXCEEDED: account storage quota exceeded - RATE_LIMITED: too many concurrent requests; retry after delay - TEAM_ROOT_NOT_WRITABLE: cannot write directly in team root RETRY GUIDANCE: - Do NOT retry on ALREADY_EXISTS or TEAM_ROOT_NOT_WRITABLE. - Follow the ASSISTANT POLICY above before calling; an explicit request with an unambiguous source file and exact destination is sufficient explicit user confirmation. - MUST NOT claim the mutation already happened until the tool returns a successful response. - Use dropbox.check_upload_file_status to poll async operations. how to revert the change: - Use dropbox.delete to remove the uploaded file. - https://help.dropbox.com/delete-restore/recover-deleted-files-folders - https://help.dropbox.com/delete-restore/recover-older-versions - https://help.dropbox.com/share/unshare-folder EXAMPLES: {"destination_path": "/Documents/report.pdf", "source_file": {"download_url": "https://files.oaiusercontent.com/report.pdf", "file_id": "file-abc123", "mime_type": "application/pdf", "file_name": "report.pdf"}} {"destination_path": "ns:123//Projects/image.png", "source_file": {"download_url": "https://files.oaiusercontent.com/image.png", "file_id": "file-xyz789"}}
who_am_i
ChatGPTTool Name: dropbox.who_am_i Purpose: Get identity, team, and namespace-root information for the authenticated Dropbox user. PARAMETERS: None required. RESPONSE CONTRACT: - account_id: Public Dropbox account ID (pid_eci) - display_name: User's full display name - email: User's email address - country, locale: Account profile fields from the authenticated user context - team_id, team_name: Team fields. team_id is a public Dropbox team ID (pid_eci). If omitted, this is a personal account. If present, this is a team account. - root_namespace_id, home_namespace_id: Namespace root fields for interpreting Dropbox paths ASSISTANT POLICY: Use this when the user asks who they are signed in as, what team/account Dropbox MCP is using, or when you need the user's root namespace or home namespace for path reasoning.
add_folder_member
Claudeadvanced_search
Claudecheck_job_status
Claudecopy
Claudecopy_file
Claudecreate_file
Claudecreate_file_request
Claudecreate_folder
Claudecreate_or_append_to_text_file
Claudecreate_shared_link
Claudecreate_text_file
Claudedelete
Claudedelete_file
Claudedelete_folder
Claudedownload_link
Claudefetch
Claudefile_preview
Claudefind_file
Claudefind_file_content_search
Claudefind_folder
Claudefind_shared_links
Claudeget_dynamic_properties_schema
Claudeget_file_metadata
Claudeget_file_request
Claudeget_latest_new_file_in_folder
Claudeget_latest_new_folder
Claudeget_latest_new_or_updated_file
Claudeget_latest_shared_folders
Claudeget_shared_link_metadata
Claudelist_dynamic_enum_values
Claudelist_file
Claudelist_file_requests
Claudelist_folder
Claudelist_folder_contents
Claudelist_shared_folder
Claudelist_shared_links
Claudelist_space
Claudemake_api_get_request
Claudemake_api_mutating_request
Claudemove
Claudemove_file
Clauderename_file
Claudesearch
Claudeset_or_remove_shared_link_expiration
Claudeset_or_remove_shared_link_password
Claudeset_shared_link_download_permission
Claudeset_shared_link_visibility_and_access
Claudeupload_file
Claudewho_am_i
Claude