# Dropbox

Dropbox is a cloud storage and file-sharing platform that allows users to store, sync, and share files across multiple devices. It provides a secure way to collaborate, back up important data, and access files from anywhere.

### **How to Integrate Dropbox with ZBrain Flow** <a href="#how-to-integrate-dropbox-with-zbrain-flow" id="how-to-integrate-dropbox-with-zbrain-flow"></a>

1. Click the '+' button in ZBrain Flow.
2. Search for Dropbox in the available integrations.
3. Select any Dropbox action to configure it.

### **How to Connect Dropbox in ZBrain Flow** <a href="#how-to-connect-dropbox-in-zbrain-flow" id="how-to-connect-dropbox-in-zbrain-flow"></a>

1. Enter the Connection Name – Provide a name to identify your Dropbox connection.
2. Click 'Connect' – Follow the authentication steps to authorize Dropbox access.
3. Click 'Save' – Your Dropbox connection is now ready for use in ZBrain Flow.

### **Actions Available in ZBrain Flow** <a href="#actions-available-in-zbrain-flow" id="actions-available-in-zbrain-flow"></a>

#### **1. Search for Files and Folders** <a href="#id-1.-search-for-files-and-folders" id="id-1.-search-for-files-and-folders"></a>

Find files and folders within Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Query** – The search string (must be at least 3 characters).
* **Enter the Path** – Define the folder path to search in (default: root).
* **Enter Max Results** – Maximum results (1-1000, default is 100).
* **Select Order By** – Choose relevance or modified time.
* **Select File Status** – Search for active or deleted files.
* **Enable/Disable Filename Only** – Restrict search to filenames.
* **Enter File Extensions** – Restrict search to specified extensions (comma-separated).
* **Enter File Categories** – Restrict search to specific categories (comma-separated).
* **Enter Account ID** – Restrict results to a specific account.

#### **2. Create a New Text File** <a href="#id-2.-create-a-new-text-file" id="id-2.-create-a-new-text-file"></a>

Generate a text file within Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Folder Path** – Define where to create the file.
* **Enter the Text** – Provide the text content.
* **Enable/Disable Auto Rename** – Avoid conflicts with duplicate names.
* **Enable/Disable Mute** – Suppress notifications for file changes.
* **Enable/Disable** **Strict Conflict** – Enforce strict revision conflict detection.

#### **3. Upload a File** <a href="#id-3.-upload-a-file" id="id-3.-upload-a-file"></a>

Upload a file to Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the File Path** – Define the upload location.
* **Enter the File** – Provide the file URL or Base64 content.
* **Enable/Disable Auto Rename** – Avoid filename conflicts.
* **Enable/Disable** **Mute** – Suppress modification notifications.
* **Enable/Disable Strict Conflict** – Enforce strict revision control.

#### **4. Get a Temporary File Link** <a href="#id-4.-get-a-temporary-file-link" id="id-4.-get-a-temporary-file-link"></a>

Generate a temporary shareable link for a file.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the File/Folder Path** – Define the target file or folder.

#### **5. Delete a File** <a href="#id-5.-delete-a-file" id="id-5.-delete-a-file"></a>

Remove a file from Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the File Path** – Define the file to be deleted.

#### **6. Move a File** <a href="#id-6.-move-a-file" id="id-6.-move-a-file"></a>

Relocate a file within Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Current Path** – Source location (e.g., `/folder1/oldfile.txt`).
* **Enter the Destination Path** – Target location (e.g., `/folder2/newfile.txt`).
* **Enable/Disable** **Auto Rename** – Avoid name conflicts.
* **Enable/Disable** **Allow Ownership Transfer** – Allow file ownership changes.

#### **7. Copy a File** <a href="#id-7.-copy-a-file" id="id-7.-copy-a-file"></a>

Duplicate a file to a new location.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Source Path** – Original file location.
* **Enter the Destination Path** – Target location.
* **Enable/Disable** **Auto Rename** – Prevent conflicts.
* **Enable/Disable Allow Ownership Transfer** – Allow ownership changes.

#### **8. Create a New Folder** <a href="#id-8.-create-a-new-folder" id="id-8.-create-a-new-folder"></a>

Generate a new folder in Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Folder Path** – Define the new folder’s location.
* **Enable/Disable** **Auto Rename** – Handle duplicate folder names.

#### **9. Delete a Folder** <a href="#id-9.-delete-a-folder" id="id-9.-delete-a-folder"></a>

Remove a folder from Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Folder Path** – Specify the folder to delete.

#### **10. Move a Folder** <a href="#id-10.-move-a-folder" id="id-10.-move-a-folder"></a>

Relocate a folder within Dropbox.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Current Path** – Folder’s existing location.
* **Enter the Destination Path** – Target location.
* **Enable/Disable** **Auto Rename** – Handle duplicate folder names.
* **Enable/Disable** **Allow Ownership Transfer** – Allow ownership changes.

#### **11. Copy a Folder** <a href="#id-11.-copy-a-folder" id="id-11.-copy-a-folder"></a>

Duplicate a folder to a new location.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Source Path** – Original folder location.
* **Enter the Destination Path** – Target location.
* **Enable/Disable** **Auto Rename** – Prevent conflicts.
* **Enable/Disable** **Allow Ownership Transfer** – Allow ownership changes.

#### **12. List Folder Contents** <a href="#id-12.-list-folder-contents" id="id-12.-list-folder-contents"></a>

Retrieve a list of files and subfolders within a directory.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the Folder Path** – Define the folder to list (use an empty string for root).
* **Enable/Disable** **Recursive Listing** – Retrieve all subfolders’ contents.
* **Enter the Limit** – Maximum results (1-2000, default is 2000).

#### **13. Custom API Call** <a href="#id-13.-custom-api-call" id="id-13.-custom-api-call"></a>

Perform a custom API request to a Dropbox endpoint.

**Configuration Steps:**

* Select a connection or create a new one.
* **Enter the API Endpoint URL** – Include the full URL or a relative path.
* Select the **HTTP Method**:
  * **GET** – Retrieve data.
  * **POST** – Send data.
  * **PATCH** – Modify existing data.
  * **PUT** – Update or replace data.
  * **DELETE** – Remove data.
  * **HEAD** – Fetch headers only.
* **Add Headers** – Define custom request headers.
  * Authorization headers are automatically injected.
* **Add Query Parameters** – Specify parameters for API customization.
* **Enter JSON Body** – Provide request payload in JSON format.
* **Set Timeout (in seconds)** – Define the request timeout duration.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-builder/flows/flow-components/dropbox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.