> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropbox Integration for AI Agents & Workflows

> Cloud file storage, sharing, and collaboration platform

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/dropbox.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=1b57efff785488e5fd82a6be18c72cc9" alt="Dropbox logo" width="72" height="72" data-path="logos/dropbox.svg" />

## Overview

Add **Dropbox** to any ModuleX agent or workflow. Cloud file storage, sharing, and collaboration via the Dropbox HTTP API (`api.dropboxapi.com/2`).

<Info>
  **Categories**: Cloud Infrastructure · Productivity & Collaboration · File Storage · Cloud Storage · **Auth**: OAuth2 · **Actions**: 12
</Info>

## Authentication

### OAuth2 Authentication

Connect using Dropbox OAuth (recommended)

#### Required Credentials

| Field         | Description                     | Required | Format            |
| ------------- | ------------------------------- | -------- | ----------------- |
| Client ID     | Dropbox OAuth App Client ID     | Yes      | `xxxxxxxxxxxxxxx` |
| Client Secret | Dropbox OAuth App Client Secret | Yes      | `xxxxxxxxxxxxxxx` |

#### OAuth Configuration

* **Authorization URL**: `https://www.dropbox.com/oauth2/authorize`
* **Token URL**: `https://api.dropboxapi.com/oauth2/token`
* **Scopes**: `files.metadata.read`, `files.metadata.write`, `files.content.read`, `files.content.write`, `sharing.read`, `sharing.write`, `account_info.read`

## Available Actions

<AccordionGroup>
  <Accordion title="create_folder — Create a new folder in the user's Dropbox">
    ### Parameters

    <ResponseField name="name" type="string" required>
      The new folder name
    </ResponseField>

    <ResponseField name="path" type="string">
      Parent folder path where the new folder will be created (empty string for root) (Default: \`\`)
    </ResponseField>

    <ResponseField name="autorename" type="boolean">
      If true, Dropbox will autorename the folder if there is a conflict (Default: `true`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "metadata": {
          "anyOf": [
            {
              "$ref": "#/$defs/FileMetadata"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateFolderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="search_files_folders — Search for files and folders by name or content">
    ### Parameters

    <ResponseField name="query" type="string" required>
      The search query string
    </ResponseField>

    <ResponseField name="path" type="string">
      Folder path to restrict the search to (empty string for all) (Default: \`\`)
    </ResponseField>

    <ResponseField name="order_by" type="string">
      Sort order: relevance, last\_modified\_time
    </ResponseField>

    <ResponseField name="file_status" type="string">
      Restrict to file status: active, deleted
    </ResponseField>

    <ResponseField name="filename_only" type="boolean">
      If true, restricts search to filenames only
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum number of results to return (defaults to 100)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        },
        "SearchMatch": {
          "additionalProperties": false,
          "description": "A single search result match.",
          "properties": {
            "match_type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Match Type"
            },
            "metadata": {
              "anyOf": [
                {
                  "$ref": "#/$defs/FileMetadata"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          "title": "SearchMatch",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "matches": {
          "items": {
            "$ref": "#/$defs/SearchMatch"
          },
          "title": "Matches",
          "type": "array"
        },
        "has_more": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Has More"
        }
      },
      "required": [
        "success"
      ],
      "title": "SearchFileFoldersOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_file_folders_in_a_folder — List all files and subfolders in a specified folder">
    ### Parameters

    <ResponseField name="path" type="string" required>
      The folder path to list contents of (empty string for root)
    </ResponseField>

    <ResponseField name="recursive" type="boolean">
      If true, list contents of all subfolders recursively (Default: `true`)
    </ResponseField>

    <ResponseField name="include_deleted" type="boolean">
      If true, include files and folders that were deleted (Default: `false`)
    </ResponseField>

    <ResponseField name="include_mounted_folders" type="boolean">
      If true, include entries under mounted folders (app, shared, team) (Default: `false`)
    </ResponseField>

    <ResponseField name="include_non_downloadable_files" type="boolean">
      If true, include non-downloadable files like Google Docs (Default: `true`)
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum number of entries to return (defaults to 100)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "entries": {
          "items": {
            "$ref": "#/$defs/FileMetadata"
          },
          "title": "Entries",
          "type": "array"
        },
        "has_more": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Has More"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListFileFoldersOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="delete_file_folder — Permanently delete a file or folder from Dropbox">
    ### Parameters

    <ResponseField name="path" type="string" required>
      Path of the file or folder to delete
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "metadata": {
          "anyOf": [
            {
              "$ref": "#/$defs/FileMetadata"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "DeleteFileFolderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="move_file_folder — Move a file or folder to a different location in Dropbox">
    ### Parameters

    <ResponseField name="path_from" type="string" required>
      Path of the file or folder to move
    </ResponseField>

    <ResponseField name="path_to" type="string" required>
      Destination folder path (file name is appended automatically)
    </ResponseField>

    <ResponseField name="autorename" type="boolean">
      If true, autorename to avoid conflicts (Default: `false`)
    </ResponseField>

    <ResponseField name="allow_ownership_transfer" type="boolean">
      Allow moves that result in ownership transfer (Default: `false`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "metadata": {
          "anyOf": [
            {
              "$ref": "#/$defs/FileMetadata"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "MoveFileFolderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="rename_file_folder — Rename a file or folder in Dropbox">
    ### Parameters

    <ResponseField name="path_from" type="string" required>
      Path of the file or folder to rename
    </ResponseField>

    <ResponseField name="new_name" type="string" required>
      The new name (include file extension for files)
    </ResponseField>

    <ResponseField name="autorename" type="boolean">
      If true, autorename to avoid conflicts (Default: `false`)
    </ResponseField>

    <ResponseField name="allow_ownership_transfer" type="boolean">
      Allow renames that result in ownership transfer (Default: `false`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "metadata": {
          "anyOf": [
            {
              "$ref": "#/$defs/FileMetadata"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "RenameFileFolderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_a_text_file — Create a new text file from plain text content">
    ### Parameters

    <ResponseField name="name" type="string" required>
      File name including extension (e.g. notes.txt)
    </ResponseField>

    <ResponseField name="path" type="string">
      Folder path where the file will be created (empty string for root) (Default: \`\`)
    </ResponseField>

    <ResponseField name="content" type="string" required>
      The text content of the new file
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "path_display": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Path Display"
        },
        "size": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Size"
        },
        "rev": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Rev"
        },
        "content_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Content Hash"
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateTextFileOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_or_append_to_a_text_file — Append a line to an existing text file, or create the file if it does not exist">
    ### Parameters

    <ResponseField name="name" type="string" required>
      File name including extension
    </ResponseField>

    <ResponseField name="path" type="string">
      Folder path (empty string for root) (Default: \`\`)
    </ResponseField>

    <ResponseField name="content" type="string" required>
      The text content to write or append
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "path_display": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Path Display"
        },
        "size": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Size"
        },
        "rev": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Rev"
        },
        "content_hash": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Content Hash"
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateOrAppendToTextFileOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_update_share_link — Create or update a public share link for a file or folder">
    ### Parameters

    <ResponseField name="path" type="string" required>
      Path of the file or folder to share
    </ResponseField>

    <ResponseField name="require_password" type="boolean">
      Enable password protection on the shared link (Default: `false`)
    </ResponseField>

    <ResponseField name="link_password" type="string">
      Password for the shared link (if require\_password is true)
    </ResponseField>

    <ResponseField name="expires" type="string">
      Expiration timestamp in ISO 8601 format (e.g. 2024-07-18T20:00:00Z)
    </ResponseField>

    <ResponseField name="audience" type="string">
      Link audience: public, team, no\_one
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "path_lower": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Path Lower"
        },
        "link_permissions": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Link Permissions"
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateUpdateShareLinkOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_shared_links — List shared links for a file or folder path">
    ### Parameters

    <ResponseField name="path" type="string">
      File or folder path to list shared links for (optional, lists all if empty)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "SharedLinkInfo": {
          "additionalProperties": false,
          "description": "Metadata for a shared link.",
          "properties": {
            "url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Url"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "expires": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Expires"
            },
            "link_permissions": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Link Permissions"
            }
          },
          "title": "SharedLinkInfo",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "links": {
          "items": {
            "$ref": "#/$defs/SharedLinkInfo"
          },
          "title": "Links",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListSharedLinksOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_shared_link_metadata — Get metadata for a shared link URL">
    ### Parameters

    <ResponseField name="shared_link_url" type="string" required>
      The URL of the shared link
    </ResponseField>

    <ResponseField name="link_password" type="string">
      Password if the shared link is password-protected
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "path_lower": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Path Lower"
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "link_permissions": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Link Permissions"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetSharedLinkMetadataOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_file_revisions — List revision history for a file">
    ### Parameters

    <ResponseField name="path" type="string" required>
      The file path to list revisions for
    </ResponseField>

    <ResponseField name="mode" type="string">
      Revision mode: path (default, revisions at same path) or id (revisions with same file id)
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Maximum number of revision entries to return
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "FileMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a file or folder returned by the Dropbox API.",
          "properties": {
            ".tag": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": ".Tag"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "path_display": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Display"
            },
            "path_lower": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Path Lower"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            },
            "rev": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Rev"
            },
            "content_hash": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Content Hash"
            },
            "server_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Server Modified"
            },
            "client_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Client Modified"
            },
            "is_downloadable": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Downloadable"
            }
          },
          "title": "FileMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "entries": {
          "items": {
            "$ref": "#/$defs/FileMetadata"
          },
          "title": "Entries",
          "type": "array"
        },
        "is_deleted": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Is Deleted"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListFileRevisionsOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Rate limits**: Dropbox applies per-app and per-user rate limits. Individual apps are limited to approximately 25,000 HTTP requests per month for free-tier apps and higher for production apps.
* **List folder**: Maximum 2,000 entries per single request (pagination via cursor for more).
* **File upload**: Maximum 150 MB per single upload request (content upload endpoint).
* **Error model**: Non-2xx responses are caught and returned as `success=False` + `error` rather than raising. Plan for retries on 429 (rate limit) responses.

## Related integrations

<CardGroup cols={3}>
  <Card title="Microsoft OneDrive" href="/integrations/tools/microsoft-onedrive" />

  <Card title="Amazon Web Services" href="/integrations/tools/aws" />

  <Card title="Azure Storage" href="/integrations/tools/azure-storage" />
</CardGroup>

## Links

* [Dropbox](https://www.dropbox.com)