# Dropbox

Your Toolhouse AI Worker can connect to Dropbox using 177 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=dropbox).

## Tools (177)

### `Dropbox Activate Team Folder`

Integration name: **DROPBOX\_ACTIVATE\_TEAM\_FOLDER**

Tool to activate an archived team folder. Use when you need to restore access to a previously archived team folder.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example         | Description                            |
| ---------------- | ------ | :------: | --------------- | -------------------------------------- |
| `team_folder_id` | string |     ✅    | `"13747111155"` | The ID of the team folder to activate. |

***

### `Dropbox Add File Member`

Integration name: **DROPBOX\_ADD\_FILE\_MEMBER**

Tool to add specified members to a Dropbox file with configurable access levels. Use when sharing a file with specific users by email or Dropbox ID. Supports custom invitation messages and notification controls. Note: This endpoint does not support apps with the app folder permission, and members will receive invitations unless quiet mode is enabled.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                | Type    | Required | Example                         | Description                                                                                                                                                                                               |
| ------------------------ | ------- | :------: | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `file`                   | string  |     ✅    | `"id:7bh4zBmgZoAAAAAAAAABCQ"`   | File to which to add members. Use the file ID format (e.g., 'id:7bh4zBmgZoAAAAAAAAABCQ') or file path.                                                                                                    |
| `quiet`                  | boolean |          | —                               | Whether to suppress device notifications for added members. If false (default), members will be notified of their invitation.                                                                             |
| `members`                | array   |     ✅    | —                               | List of members to add to the file. Each member is identified by email or Dropbox ID. Note: If an email is provided and it's the user's main account email, they may be directly added to the membership. |
| `access_level`           | object  |          | —                               | Defines the access level for the new member.                                                                                                                                                              |
| `custom_message`         | string  |          | `"Please review this document"` | Custom message to include in the invitation email sent to added members.                                                                                                                                  |
| `add_message_as_comment` | boolean |          | —                               | If true and a custom\_message is provided, the message will be added as a comment on the file.                                                                                                            |

***

### `Dropbox Add File Properties`

Integration name: **DROPBOX\_ADD\_FILE\_PROPERTIES**

Tool to add custom properties to a Dropbox file using a filled property template. Use when you need to tag files with structured metadata like project info, status, or categories.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                                            |
| ------------------------- | ------ | :------: | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `path`                    | string |     ✅    | `"/test_properties (1).txt"`                  | A unique identifier for the file or folder. Can be a file path (e.g., '/test.txt') or a file ID (e.g., 'id:a4ayc\_80\_OEAAAAAAAAAXw'). |
| `property_groups`         | array  |     ✅    | —                                             | The property groups to be added to the Dropbox file. Each group must reference a valid template that the file doesn't already have.    |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on.               |

***

### `Dropbox Add File Tags`

Integration name: **DROPBOX\_ADD\_FILE\_TAGS**

Tool to add a tag to a file or folder in Dropbox. Use when you need to tag items for organization. Tags are automatically converted to lowercase.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                              |
| ------------------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `path`                    | string |     ✅    | `"/test-tag-file.txt"`                        | Path to the file or folder to tag. Must be a valid path in the user's Dropbox.                                           |
| `tag_text`                | string |     ✅    | `"important"`                                 | The tag text to add. Will be automatically converted to lowercase letters by Dropbox.                                    |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on. |

***

### `Dropbox Add Folder Member Action`

Integration name: **DROPBOX\_ADD\_FOLDER\_MEMBER\_ACTION**

Tool to add members to a shared folder with specified access levels. Use when an owner or editor needs to invite new members to a shared folder. Members receive invites and must be mounted via mount\_folder for full access. Requires appropriate ACL permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example         | Description                                                                                                                                          |
| ------------------ | ------- | :------: | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `quiet`            | boolean |          | —               | Whether to suppress email and device notifications for the added members. If true, members are added silently without notification. Default is false |
| `members`          | array   |     ✅    | —               | List of members to add to the shared folder. Each member will receive an invitation to join the folder                                               |
| `custom_message`   | string  |          | —               | Optional custom message to include in the invitation email sent to added members                                                                     |
| `shared_folder_id` | string  |     ✅    | `"84528192421"` | The ID of the shared folder to add members to. You can get this from list\_shared\_folders action                                                    |

***

### `Dropbox Add Member Space Limits Excluded Users`

Integration name: **DROPBOX\_ADD\_MEMBER\_SPACE\_LIMITS\_EXCLUDED\_USERS**

Tool to add users to the team's space limits exclusion list in Dropbox. Users on this list are exempt from space limit restrictions. Use when you need to exclude specific team members from storage quota enforcement. Requires team admin authentication.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                                                                                                                                   |
| --------- | ----- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `users`   | array |     ✅    | —       | List of users to be added to the space limits exclusion list. Each user can be specified by team\_member\_id, external\_id, or email. Maximum size of the list is 1000 users. |

***

### `Dropbox Add Sharing Allowlist`

Integration name: **DROPBOX\_ADD\_SHARING\_ALLOWLIST**

Tool to add domains or email addresses to the team sharing allowlist. Use when team admins need to approve specific domains or emails for sharing. Requires team admin authentication. At least one of 'domains' or 'emails' must be provided, with a maximum of 100 entries per call.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example              | Description                                                                                                                                                                                                                                          |
| --------- | ----- | :------: | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `emails`  | array |          | `"user@example.com"` | List of email addresses to add to the allowlist. Each email must be a valid string representation following RFC-5322/822 (e.g., '<user@example.com>'). Maximum 100 entries per call. At least one of 'domains' or 'emails' must be provided          |
| `domains` | array |          | `"example.com"`      | List of domains to add to the allowlist. Each domain must be a valid string representation following RFC-1034/5 (e.g., 'example.com', 'subdomain.example.org'). Maximum 100 entries per call. At least one of 'domains' or 'emails' must be provided |

***

### `Dropbox Add Team Group Members`

Integration name: **DROPBOX\_ADD\_TEAM\_GROUP\_MEMBERS**

Tool to add members to a team group with specified access levels. Use when you need to add users to an existing team group. Requires team admin credentials with group management permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example | Description                                                                                                |
| ---------------- | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------------------- |
| `group`          | object  |     ✅    | —       | The group to add members to. Use group\_id obtained from list\_team\_groups or create\_team\_group actions |
| `members`        | array   |     ✅    | —       | List of members to add to the group with their respective access levels                                    |
| `return_members` | boolean |          | —       | Whether to return the list of members in the group after adding. Default is true                           |

***

### `Dropbox Add Team Members`

Integration name: **DROPBOX\_ADD\_TEAM\_MEMBERS**

Tool to add new members to a Dropbox team. Use when you need to invite users to join the team with specified roles and settings. Maximum of 20 members per request. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                                                                                                          |
| ------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `force_async` | boolean |          | —       | Whether to force the operation to happen asynchronously. If true, returns an async\_job\_id to poll for completion. Default is false |
| `new_members` | array   |     ✅    | —       | List of new members to add to the team. Maximum of 20 members per request                                                            |

***

### `Dropbox Add Team Members Secondary Emails`

Integration name: **DROPBOX\_ADD\_TEAM\_MEMBERS\_SECONDARY\_EMAILS**

Tool to add secondary email addresses to Dropbox team members. Use when you need to associate additional email addresses with team member accounts. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type  | Required | Example | Description                                                                                                                            |
| ---------------------- | ----- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `new_secondary_emails` | array |     ✅    | —       | List of users and their secondary emails to add. Each entry specifies a user (by ID or email) and the secondary emails to add for them |

***

### `Dropbox Add Team Properties Template`

Integration name: **DROPBOX\_ADD\_TEAM\_PROPERTIES\_TEMPLATE**

Tool to add a property template for a team in Dropbox. Use when you need to create a standardized set of custom properties that can be applied to files and folders. Requires team admin permissions and a Dropbox Business account.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                                          | Description                                                                                                              |
| ------------- | ------ | :------: | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `name`        | string |     ✅    | `"Project Metadata"`                             | Display name for the template. Template names can be up to 256 bytes.                                                    |
| `fields`      | array  |     ✅    | —                                                | Definitions of the property fields associated with this template. There can be up to 32 properties in a single template. |
| `description` | string |     ✅    | `"Template for project-related file properties"` | Description for the template. Template descriptions can be up to 1024 bytes.                                             |

***

### `Dropbox Alpha Upload File`

Integration name: **DROPBOX\_ALPHA\_UPLOAD\_FILE**

Tool to upload a new file to Dropbox using the alpha upload endpoint. Use when uploading files up to 150 MiB. Note that the behavior of this alpha endpoint is unstable and subject to change.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example                                      | Description                                                                                                                                                                                          |
| ------------------------- | ------- | :------: | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mode`                    | string  |          | `"add"`                                      | Selects what to do if the file already exists.                                                                                                                                                       |
| `mute`                    | boolean |          | —                                            | If true, this tells the clients that this modification shouldn't result in a user notification.                                                                                                      |
| `path`                    | string  |     ✅    | `"/test_upload_alpha.txt"`                   | Path in the user's Dropbox to save the file. Must start with '/' and include the filename.                                                                                                           |
| `content`                 | object  |     ✅    | —                                            | File to be uploaded. Supports various formats including text, images, and PDFs.                                                                                                                      |
| `autorename`              | boolean |          | —                                            | If there's a conflict as determined by mode, have the Dropbox server try to autorename the file to avoid conflict.                                                                                   |
| `client_modified`         | string  |          | `"2015-05-12T15:50:38Z"`                     | The value to store as the client\_modified timestamp in ISO 8601 format (e.g., '2015-05-12T15:50:38Z'). Dropbox automatically records the time at which the file was written to the Dropbox servers. |
| `property_groups`         | array   |          | —                                            | List of custom properties to add to file.                                                                                                                                                            |
| `dropbox_api_select_user` | string  |          | `"dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc"` | Optional. For team accounts: Dropbox account ID or team member ID to operate on. Required when using a Dropbox Business team token. Format: 'dbid:...' or team\_member\_id.                          |

***

### `Dropbox Append Upload Session`

Integration name: **DROPBOX\_APPEND\_UPLOAD\_SESSION**

Tool to append more data to an existing upload session. Use when uploading large files in chunks. When the 'close' parameter is set to true, this call will close the session. A single request should not upload more than 150 MiB.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                     |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `close`   | boolean |          | —       | If true, the upload session will be closed after appending this data. Once closed, no more data can be appended to the session. |
| `cursor`  | object  |     ✅    | —       | Cursor information containing the session\_id and current offset in bytes.                                                      |
| `content` | object  |     ✅    | —       | File data to append to the upload session.                                                                                      |

***

### `Dropbox Append Upload Session Batch`

Integration name: **DROPBOX\_APPEND\_UPLOAD\_SESSION\_BATCH**

Tool to append data to multiple upload sessions in a single request. Use when you need to upload data to multiple ongoing upload sessions efficiently. The file content for each session should be concatenated in the request body in the order specified by entries. A single request should not upload more than 150 MiB. The maximum size of a file one can upload to an upload session is 2^41 - 2^22 (2,199,019,061,248) bytes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                                                           | Description                                                                                                                                                                                                                                                            |
| --------- | ------ | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`    | string |     ✅    | —                                                                                                                                                                                                                                                                                 | Concatenated binary data for all upload sessions. The data for each session should be concatenated in the order specified in the entries list. Each chunk's length must match the corresponding entry's length field.                                                  |
| `entries` | array  |     ✅    | `[{"close":false,"cursor":{"offset":0,"session_id":"pid_upload_session:ABIKOUDCsWWOgGdtWNm2an-FHOPmw0W9zejs1OOQmkD9nDw_0A"},"length":23},{"close":false,"cursor":{"offset":0,"session_id":"pid_upload_session:ABIKOWkEtG7FziZAUMOmoMO9PqPN8YXp_1T2ESGA8m3i91Koww"},"length":23}]` | List of upload session entries to append data to. Each entry specifies the session, how many bytes to read from the request body, and whether to close the session. The data for each entry should be concatenated in the request body in the same order as this list. |

***

### `Dropbox Archive Team Folder`

Integration name: **DROPBOX\_ARCHIVE\_TEAM\_FOLDER**

Tool to archive an active team folder in Dropbox. Sets the team folder's status to archived and removes all folder and file members. Use when you need to archive a team folder that is no longer in active use. The folder must be active before it can be archived.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example         | Description                                                                                                                                                                                                       |
| ----------------- | ------- | :------: | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `team_folder_id`  | string  |     ✅    | `"13746671955"` | The ID of the team folder to archive. You can get this from list team folders action. The team folder must be active to be archived.                                                                              |
| `force_async_off` | boolean |          | —               | Whether to force the operation to run synchronously. If true, the operation will complete synchronously and return metadata immediately. If false or not specified, large operations may complete asynchronously. |

***

### `Dropbox Check Copy Batch`

Integration name: **DROPBOX\_CHECK\_COPY\_BATCH**

Tool to check the status of an asynchronous copy batch job in Dropbox. Use when you have an async\_job\_id from a previous copy\_batch operation and need to poll its status. Returns 'in\_progress', 'complete' with results for each entry, or 'failed' with error details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                 |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AAA9W0f2HDJ_ueldO2YD4S79kpnkhll-mrToXietsd8rGZzchE9jsW0kaCDsvq-YTzDQrw9sYwicXx9kKkxCWNGG"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check Delete Batch`

Integration name: **DROPBOX\_CHECK\_DELETE\_BATCH**

Tool to check the status of an asynchronous delete batch job in Dropbox. Use when you need to poll the status of a batch delete operation initiated by delete\_batch. Returns 'in\_progress', 'complete' with per-entry results, 'failed', or error status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                 |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AAAaeWLoZIbMa1Fx1uvOS1tDOhJ1ckaZOjW8jybNTW5pTWMQnBvaMExxK102UD562_zWXNU7h0sU_LUrp5_njKwB"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check Folder Batch`

Integration name: **DROPBOX\_CHECK\_FOLDER\_BATCH**

Tool to check the status of an asynchronous folder batch creation job. Use when you need to poll the status of a create\_folder\_batch operation. Returns 'in\_progress', 'complete' with results, or 'failed' with error details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                   |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AABoj8Vt1v4sW75PK135T6dbQLwXD1yPwF6uHRcaxqX0qDvNXhznIsvYKfHYUA9LxEhPCIWTR4p_2ovDqRi345VM"` | ID of the asynchronous job. This is the value returned from the create\_folder\_batch method. |

***

### `Dropbox Check Job Status`

Integration name: **DROPBOX\_CHECK\_JOB\_STATUS**

Tool to check the status of an asynchronous sharing job in Dropbox. Use when you have an async\_job\_id from a previous sharing operation (like unshare\_folder, remove\_folder\_member) and need to poll its status. Returns 'in\_progress', 'complete', 'failed' with error details, or polling errors.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                 |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AACD-aM8Oi5GiB_EqlBYrJkGDEn7tnoSiRcq6xDKrb6TiphCH0wTGpI0bB8RxddGIOQSTAWgU1zz69S4XUwTWcSr"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check Move Batch`

Integration name: **DROPBOX\_CHECK\_MOVE\_BATCH**

Tool to check the status of an asynchronous move batch job. Use when you need to poll the status of a batch move operation started with move\_batch\_v2. Returns a list of results for each entry when complete.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                 |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AADqyYPi40MIgqklWOM-Mp7inh5v2jPlwhPTpREgh4cp8aQAHArn6pvoHeqYL2Tp9jEOA4tvmj1itOUKTVAFxXMw"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check Move Former Member Files Job Status`

Integration name: **DROPBOX\_CHECK\_MOVE\_FORMER\_MEMBER\_FILES\_JOB\_STATUS**

Tool to check the status of an asynchronous move former member files job. Use when you have an async\_job\_id from a previous team/members/move\_former\_member\_files operation and need to poll its completion status. Returns 'in\_progress', 'complete', 'failed' with error details, or error states like 'invalid\_async\_job\_id'.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                 | Description                                                                                                                                    |
| -------------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"34g93hh34h04y384084"` | Id of the asynchronous job returned from team/members/move\_former\_member\_files. This is used to poll the status of the file move operation. |

***

### `Dropbox Check Remove Member`

Integration name: **DROPBOX\_CHECK\_REMOVE\_MEMBER**

Tool to check the status of an asynchronous remove folder member job in Dropbox. Use when you have an async\_job\_id from a previous remove\_folder\_member operation and need to poll its status. Returns 'in\_progress', 'complete' with access level info, or 'failed' with error details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                          | Description                                                                                                 |
| -------------- | ------ | :------: | -------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:your_async_job_id_here"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check Save Url Status`

Integration name: **DROPBOX\_CHECK\_SAVE\_URL\_STATUS**

Tool to check the status of a save\_url job in Dropbox. Use when you have an async\_job\_id from a save\_url operation and need to poll its completion status. Returns 'in\_progress', 'complete' with file metadata, or 'failed' with error details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                    | Description                                                    |
| -------------- | ------ | :------: | -------------------------- | -------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"lOcA8blEoY4AAAAAAAAAAQ"` | The async job ID returned from a previous save\_url operation. |

***

### `Dropbox Check Share Job Status`

Integration name: **DROPBOX\_CHECK\_SHARE\_JOB\_STATUS**

Tool to check the status of an asynchronous folder sharing job in Dropbox. Use when you need to poll the status of a folder share operation that was initiated asynchronously. Returns 'in\_progress', 'complete' with folder metadata, 'failed' with error details, or polling error status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                 |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AABzGEzOnfiAAEN85fWdkEADcgkMoSXuqPmBsY_vJEKk_pUn5N2rLXMQ7hLs67sh4UZiFcP69U4nNAmUim_IqdO4"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check Team Folder Archive`

Integration name: **DROPBOX\_CHECK\_TEAM\_FOLDER\_ARCHIVE**

Tool to check the status of an asynchronous team folder archive job in Dropbox. Use when you have an async\_job\_id from a previous team\_folder/archive operation and need to poll its status. Returns 'in\_progress' while archiving, 'complete' with team folder metadata when done, or error states like 'invalid\_async\_job\_id'.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                   |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AACyVg9Hu8Lp5jLDVqbUGMkeDUIQvFMV8QkHnvV9lbXOFKCkQeqWdDiCuHUphKDxBziprdjNjpswqqoG9xUJ9upm"` | Id of the asynchronous job returned from the team\_folder/archive method that launched the archive operation. |

***

### `Dropbox Check Upload Batch`

Integration name: **DROPBOX\_CHECK\_UPLOAD\_BATCH**

Tool to check the status of an asynchronous upload batch job in Dropbox. Use when you need to poll the status of a batch upload operation initiated by upload\_session/finish\_batch. Returns 'in\_progress', 'complete' with per-entry results, or error status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                | Description                                                                                                 |
| -------------- | ------ | :------: | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"pid_upload_result:ABIKOTGn3VW8UUPSFEGZIJY7TpYv-HSdyGw8Y0DBsz-jPTf8"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job. |

***

### `Dropbox Check User`

Integration name: **DROPBOX\_CHECK\_USER**

Tool to test Dropbox API connection and validate access token by echoing back a supplied string. Use when you need to verify that the Dropbox API is accessible and the access token is valid.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                                                            |
| --------- | ------ | :------: | ------- | -------------------------------------------------------------------------------------- |
| `query`   | string |          | `"foo"` | The string that you'd like to be echoed back to you. Maximum length is 500 characters. |

***

### `Dropbox Copy Batch`

Integration name: **DROPBOX\_COPY\_BATCH**

Tool to copy multiple files or folders to different locations at once in Dropbox. Use when you need to duplicate multiple items efficiently. This operation may complete synchronously or return a job ID for async processing. Use copy\_batch/check:2 to check async job status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example                                       | Description                                                                                                                           |
| ------------------------- | ------- | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `entries`                 | array   |     ✅    | —                                             | List of entries to be copied. Each entry is a RelocationPath with from\_path and to\_path.                                            |
| `autorename`              | boolean |          | —                                             | If there's a conflict with any file, have the Dropbox server try to autorename that file to avoid the conflict. The default is false. |
| `dropbox_api_select_user` | string  |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on.              |

***

### `Dropbox Copy File Or Folder`

Integration name: **DROPBOX\_COPY\_FILE\_OR\_FOLDER**

Tool to copy a file or folder to a different location in Dropbox. Use when you need to duplicate content without removing the original. If the source path is a folder, all its contents will be copied.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                  | Type    | Required | Example                                       | Description                                                                                                                                                                                 |
| -------------------------- | ------- | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `to_path`                  | string  |     ✅    | `"/Homework/archive/math_prime_numbers.txt"`  | Path in the user's Dropbox that is the destination. This path is case-sensitive.                                                                                                            |
| `from_path`                | string  |     ✅    | `"/Homework/math/prime_numbers.txt"`          | Path in the user's Dropbox to be copied. This path is case-sensitive.                                                                                                                       |
| `autorename`               | boolean |          | —                                             | If there's a conflict (e.g., a file with the same name already exists at the destination), have the Dropbox server try to auto-rename the file to avoid the conflict. The default is false. |
| `allow_shared_folder`      | boolean |          | —                                             | If true, allows copying of shared folders. Note: This flag has no effect in current API version. The default is false.                                                                      |
| `dropbox_api_select_user`  | string  |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on.                                                                    |
| `allow_ownership_transfer` | boolean |          | —                                             | Allow moves by owner even if it would result in an ownership transfer for the content being moved. Note: This does not apply to copies. The default is false.                               |

***

### `Dropbox Count File Requests`

Integration name: **DROPBOX\_COUNT\_FILE\_REQUESTS**

Tool to get the total number of file requests owned by the authenticated user. Use when you need to count how many file requests (both open and closed) exist.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Create File Request`

Integration name: **DROPBOX\_CREATE\_FILE\_REQUEST**

Tool to create a new file request in Dropbox. Use when you need to request files from others by generating a unique link for uploads to a specified Dropbox folder, optionally with a deadline.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                                                                                                    |
| ------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `open`        | boolean |          | —       | Whether the file request should be open by default. If true, the file request will start accepting files immediately.          |
| `title`       | string  |     ✅    | —       | The title of the new file request. Must be 1 character or more.                                                                |
| `deadline`    | object  |          | —       | Represents the deadline parameters for a file request.                                                                         |
| `destination` | string  |     ✅    | —       | The path in the user's Dropbox where uploaded files will be saved. Must be a path starting with '/'. Example: '/Homework/math' |

***

### `Dropbox Create Folder`

Integration name: **DROPBOX\_CREATE\_FOLDER**

Tool to create a new folder at a specified path in Dropbox. Use when you need to organize files by creating a new directory.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example          | Description                                                                                                                                                                                                                                                                     |
| ------------ | ------- | :------: | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`       | string  |     ✅    | `"/test_folder"` | Path in the user's Dropbox to create the folder. Must start with a slash. May use 'id:' prefix for namespace-based paths. Must not end with '/' or whitespace. Paths are case-insensitive but must be correctly formatted to avoid validation errors.                           |
| `autorename` | boolean |          | —                | If there's a conflict, have the Dropbox server try to autorename the folder to avoid the conflict. Default is False. Without autorename, a conflict returns a `path_conflict` error. For idempotent folder creation, set autorename=true or treat `path_conflict` as non-fatal. |

***

### `Dropbox Create Folder Batch`

Integration name: **DROPBOX\_CREATE\_FOLDER\_BATCH**

Tool to create multiple folders at once in Dropbox. Use when you need to create several folders efficiently in a single request. For large batches, returns a job ID immediately and runs asynchronously; for smaller inputs, creates folders and returns results synchronously.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                             | Description                                                                                                                                                                 |
| ------------- | ------- | :------: | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paths`       | array   |     ✅    | `["/test_folder1","/test_folder2"]` | List of paths to be created in the user's Dropbox. Each path must start with a slash. Duplicate path arguments in the batch are considered only once. Maximum 10,000 paths. |
| `autorename`  | boolean |          | —                                   | If there's a conflict, have the Dropbox server try to autorename the folder to avoid the conflict. Default is False.                                                        |
| `force_async` | boolean |          | —                                   | Whether to force the create to happen asynchronously. For large batches, the operation will be asynchronous automatically. Default is False.                                |

***

### `Dropbox Create Paper Document`

Integration name: **DROPBOX\_CREATE\_PAPER\_DOCUMENT**

Creates a new Dropbox Paper document at the specified path using HTML or Markdown content.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                     | Description                                                                                                                                                     |
| --------------- | ------ | :------: | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`          | string |     ✅    | `"/Paper Docs/New Doc.paper"`               | The fully qualified path in Dropbox where the Paper document will be created. MUST include the .paper extension at the end (e.g., '/My Documents/Notes.paper'). |
| `content`       | string |     ✅    | `"<h1>My Document</h1><p>Content here</p>"` | Content of the paper document                                                                                                                                   |
| `import_format` | string |          | `"html"`                                    | Format of the provided content                                                                                                                                  |

***

### `Dropbox Create Paper Folder`

Integration name: **DROPBOX\_CREATE\_PAPER\_FOLDER**

Tool to create a new Paper folder with the provided info. Use when you need to organize Paper documents by creating a new folder. Note: This endpoint works for content created by users on the older version of Paper.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                | Description                                                                                                                                |
| ------------------ | ------- | :------: | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `name`             | string  |     ✅    | `"Test Paper Folder"`  | The name of the new Paper folder.                                                                                                          |
| `is_team_folder`   | boolean |          | —                      | Whether the folder to be created should be a team folder. If not specified, defaults to false.                                             |
| `parent_folder_id` | string  |          | `"e.1234567890abcdef"` | The encrypted Paper folder Id where the new Paper folder should be created. If not provided, the folder will be created at the root level. |

***

### `Dropbox Create Shared Link`

Integration name: **DROPBOX\_CREATE\_SHARED\_LINK**

Tool to create a stable, long-lived shared link for a Dropbox file or folder. Use when the user needs a permanent URL suitable for embedding or long-term sharing (as opposed to temporary links that expire in hours). Supports optional settings like expiration, password protection, and visibility controls. Note: If a shared link already exists for the path, the API will return an error; in that case, use a separate list\_shared\_links endpoint to retrieve existing links.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                   | Description                                                                                                                                         |
| ---------- | ------ | :------: | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`     | string |     ✅    | `"/Documents/report.pdf"` | The path or file identifier to be shared by the shared link. Supports Dropbox path (e.g., '/folder/file.txt'), id:..., rev:..., or ns:... notation. |
| `settings` | object |          | —                         | Settings for the shared link configuration.                                                                                                         |

***

### `Dropbox Create Shared Link Simple`

Integration name: **DROPBOX\_CREATE\_SHARED\_LINK\_SIMPLE**

DEPRECATED: Use CreateSharedLinkV2 instead. Tool to create a basic shared link for a Dropbox file or folder. If a shared link already exists for the given path, that link is returned. Use when you need a simple shared link without advanced settings like password protection or custom expiration. For links with advanced settings, use the create\_shared\_link action instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                   | Description                                                                                                                                                                                          |
| ---------------- | ------- | :------: | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`           | string  |     ✅    | `"/Documents/report.pdf"` | The path to share. This can be a file or folder path in Dropbox (e.g., '/folder/file.txt'). If a shared link already exists for this path, that link will be returned instead of creating a new one. |
| `short_url`      | boolean |          | —                         | Whether to return a shortened URL. If true, the returned URL will be shorter and easier to share.                                                                                                    |
| `pending_upload` | object  |          | —                         | Mode for pending upload indicating file or folder type.                                                                                                                                              |

***

### `Dropbox Create Team Folder`

Integration name: **DROPBOX\_CREATE\_TEAM\_FOLDER**

Tool to create a new, active team folder with no members in Dropbox. Use when you need to set up a new team folder for collaboration. The folder is created without any members initially.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example       | Description                                                            |
| -------------- | ------ | :------: | ------------- | ---------------------------------------------------------------------- |
| `name`         | string |     ✅    | `"Marketing"` | Name for the new team folder. The name must be unique within the team. |
| `sync_setting` | string |          | —             | Sync setting enum for the team folder.                                 |

***

### `Dropbox Create Team Group`

Integration name: **DROPBOX\_CREATE\_TEAM\_GROUP**

Tool to create a new, empty team group in Dropbox with a specified name. Use when you need to create a new group for organizing team members. Requires team admin credentials with team member management permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example            | Description                                                                                                     |
| ----------------------- | ------ | :------: | ------------------ | --------------------------------------------------------------------------------------------------------------- |
| `group_name`            | string |     ✅    | `"Marketing Team"` | The name for the new group. Must not be empty.                                                                  |
| `group_external_id`     | string |          | —                  | An arbitrary external ID that the creator of the team can associate with the group for organizational purposes. |
| `group_management_type` | string |          | —                  | The type of group management for the team group.                                                                |

***

### `Dropbox Delete All Closed File Requests`

Integration name: **DROPBOX\_DELETE\_ALL\_CLOSED\_FILE\_REQUESTS**

Tool to delete all closed file requests owned by the current user. Use when you need to clean up closed file requests in bulk.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Delete Batch`

Integration name: **DROPBOX\_DELETE\_BATCH**

Tool to delete multiple files or folders at once in Dropbox. Use when you need to delete several items simultaneously. This route is asynchronous and returns a job ID immediately for large batches. Use delete\_batch/check to verify completion status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                                | Description                                                           |
| --------- | ----- | :------: | ------------------------------------------------------ | --------------------------------------------------------------------- |
| `entries` | array |     ✅    | `[{"path":"/file1.txt"},{"path":"/folder/file2.pdf"}]` | List of files or folders to delete. Maximum 1000 entries per request. |

***

### `Dropbox Delete File`

Integration name: **DROPBOX\_DELETE\_FILE**

Tool to delete a file or folder at the specified path in Dropbox. Use when you need to permanently remove a file or folder and all its contents.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example            | Description                                                                                                            |
| ------------ | ------ | :------: | ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `path`       | string |     ✅    | `"/test_file.txt"` | Path in the user's Dropbox to delete. The path must start with a slash.                                                |
| `parent_rev` | string |          | —                  | Perform delete if given 'rev' matches the existing file's latest 'rev'. This field does not support deleting a folder. |

***

### `Dropbox Delete File Or Folder`

Integration name: **DROPBOX\_DELETE\_FILE\_OR\_FOLDER**

DEPRECATED: Use DeleteFile instead. Permanently and irreversibly deletes the file or folder at the specified path in Dropbox. Folder deletion is recursive — all nested contents are removed. Always obtain explicit user confirmation before calling, especially for folders. Requires the `files.content.write` scope.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                              |
| --------- | ------ | :------: | ------- | ---------------------------------------- |
| `path`    | string |     ✅    | —       | The path to the file or folder to delete |

***

### `Dropbox Delete File Requests`

Integration name: **DROPBOX\_DELETE\_FILE\_REQUESTS**

Tool to delete a batch of closed file requests in Dropbox. Use when you need to remove multiple file requests that are no longer needed. Only closed file requests can be deleted; attempting to delete open file requests will fail.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                           | Description                                                                   |
| --------- | ----- | :------: | ------------------------------------------------- | ----------------------------------------------------------------------------- |
| `ids`     | array |     ✅    | `["oaCAVmEyrqYnkZX9955Y","BaZmehYoXMPtaRmfTbSG"]` | List of file request IDs to delete. Only closed file requests can be deleted. |

***

### `Dropbox Delete Manual Contacts Batch`

Integration name: **DROPBOX\_DELETE\_MANUAL\_CONTACTS\_BATCH**

Tool to delete specific manually added contacts from Dropbox by their email addresses. Use when you need to remove contacts that were manually added to a user's Dropbox account.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                                                                    |
| ------------------------- | ------ | :------: | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `email_addresses`         | array  |     ✅    | `["test1@example.com","test2@example.com"]`   | List of email addresses of manually added contacts to delete. Must be valid email addresses.                                                                   |
| `dropbox_api_select_user` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) to specify which team member's contacts to delete. Required when using team OAuth tokens. Optional for individual accounts. |

***

### `Dropbox Delete Team Folder Permanently`

Integration name: **DROPBOX\_DELETE\_TEAM\_FOLDER\_PERMANENTLY**

Tool to permanently delete an archived team folder in Dropbox. Use when you need to permanently remove an archived team folder and all its contents. The team folder must be archived before it can be permanently deleted.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example         | Description                                                                                                                                                             |
| ---------------- | ------ | :------: | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `team_folder_id` | string |     ✅    | `"13746671955"` | The ID of the team folder to permanently delete. The team folder must be archived before it can be permanently deleted. You can get this from list team folders action. |

***

### `Dropbox Delete Team Group`

Integration name: **DROPBOX\_DELETE\_TEAM\_GROUP**

Tool to delete a Dropbox team group. Use when you need to remove a team group. Note that this requires team admin permissions and the group cannot be system-managed.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type   | Required | Example                                | Description                                                                                                                                                                  |
| ------------------- | ------ | :------: | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group_id`          | string |          | `"g:e18cdeb8c1e9c0280000000000000053"` | The Dropbox group ID. Required when selector\_type is 'group\_id'. Example: 'g:e18cdeb8c1e9c0280000000000000053'                                                             |
| `selector_type`     | string |     ✅    | `"group_id"`                           | The type of selector to use for identifying the group. 'group\_id' - Select group by Dropbox group ID. 'group\_external\_id' - Select group by external ID.                  |
| `group_external_id` | string |          | —                                      | The external ID of the group. Required when selector\_type is 'group\_external\_id'. This is the ID from an external system that has been associated with the Dropbox group. |

***

### `Dropbox Delete Team Member Profile Photo`

Integration name: **DROPBOX\_DELETE\_TEAM\_MEMBER\_PROFILE\_PHOTO**

Tool to delete a team member's profile photo. Use when you need to remove the profile picture of a team member. Requires team admin permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                            |
| --------- | ------ | :------: | ------- | ------------------------------------------------------ |
| `user`    | object |     ✅    | —       | The team member whose profile photo should be deleted. |

***

### `Dropbox Delete Team Members Secondary Emails`

Integration name: **DROPBOX\_DELETE\_TEAM\_MEMBERS\_SECONDARY\_EMAILS**

Tool to delete secondary email addresses from Dropbox team members. Use when you need to remove secondary emails from one or more team members. Requires team member management permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type  | Required | Example | Description                                                                                                                         |
| ------------------ | ----- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `emails_to_delete` | array |     ✅    | —       | List of users and their secondary emails to delete. Each entry specifies a user and which secondary emails to remove from that user |

***

### `Dropbox Download Zip`

Integration name: **DROPBOX\_DOWNLOAD\_ZIP**

Tool to download a folder from Dropbox as a zip file. Use when you need to download an entire folder structure with multiple files. The folder must be less than 20 GB in size with any single file less than 4 GB, and the resulting zip must have fewer than 10,000 total entries.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                      | Description                                                                                                                                                                                                                                              |
| --------- | ------ | :------: | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`    | string |     ✅    | `"/Documents/project_files"` | The path to the folder to download as a zip file. Must be a folder path, not a single file. The folder must be less than 20 GB in size with any single file less than 4 GB. The resulting zip must have fewer than 10,000 total file and folder entries. |

***

### `Dropbox Export File`

Integration name: **DROPBOX\_EXPORT\_FILE**

Tool to export non-downloadable Dropbox files (especially Dropbox Paper) to Markdown/HTML/plain text and return usable content. Use when you need to access content from files that cannot be downloaded directly, such as Dropbox Paper documents or Google Docs stored in Dropbox. Requires files.content.read scope.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                     | Description                                                                                                                                                                                     |
| --------------- | ------ | :------: | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mode`          | string |          | —                           | 'return\_text': return exported text directly (truncated safely if very large). 'store\_and\_link': create a temporary Dropbox download link to the original file.                              |
| `path`          | string |     ✅    | `"/Documents/sample.paper"` | The path of the file to be exported. Supports Dropbox path (e.g., '/folder/file.paper'), id:..., rev:..., or ns:... notation. Use this for non-downloadable files like Dropbox Paper documents. |
| `export_format` | string |          | `"markdown"`                | The file format to export to. Common values: 'markdown', 'html', 'plain\_text'. If not specified, the default format for the file type will be used. For Dropbox Paper, default is 'markdown'.  |

***

### `Dropbox Files Search`

Integration name: **DROPBOX\_FILES\_SEARCH**

Tool to search for files and folders in Dropbox by name or content. Use when you need to find items matching a search query within a specific path or across the entire Dropbox.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example  | Description                                                                                                                                                                                                       |
| ------------- | ------- | :------: | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mode`        | string  |          | —        | Search mode for Dropbox files search.                                                                                                                                                                             |
| `path`        | string  |          | `""`     | The path in the user's Dropbox to search. Should probably be a folder. Use empty string to search the entire Dropbox.                                                                                             |
| `query`       | string  |     ✅    | `"test"` | The string to search for. The search string is split on spaces into multiple tokens. For file name searching, the last token is used for prefix matching (e.g., 'bat c' matches 'bat cave' but not 'batman car'). |
| `start`       | integer |          | —        | The starting index within the search results (used for paging). Default is 0.                                                                                                                                     |
| `max_results` | integer |          | —        | The maximum number of search results to return. Default is 100, max is 1000.                                                                                                                                      |

***

### `Dropbox Finish Upload Session`

Integration name: **DROPBOX\_FINISH\_UPLOAD\_SESSION**

Tool to finish an upload session and save the uploaded data to the given file path. Use when completing a multi-part upload after using upload\_session/start and upload\_session/append. A single request should not upload more than 150 MiB. The maximum size of a file one can upload to an upload session is 2,199,019,061,248 bytes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                                                                                        |
| --------- | ------ | :------: | ------- | ------------------------------------------------------------------------------------------------------------------ |
| `commit`  | object |     ✅    | —       | Contains the path and other optional modifiers for the commit.                                                     |
| `cursor`  | object |     ✅    | —       | Cursor information containing the session\_id and current offset in bytes.                                         |
| `content` | object |          | —       | Final file data to append before finishing the session. Can be omitted if no additional data needs to be appended. |

***

### `Dropbox Finish Upload Session Batch`

Integration name: **DROPBOX\_FINISH\_UPLOAD\_SESSION\_BATCH**

Tool to commit many files at once into a user's Dropbox after uploading file contents via upload\_session/start and upload\_session/append. Use when you need to finish multiple upload sessions in a single request. Returns an async\_job\_id which can be used with upload\_session/finish\_batch/check to poll for completion. Maximum 1000 entries per request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                                                                                        |
| --------- | ----- | :------: | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `entries` | array |     ✅    | —       | List of upload sessions to finish. Each entry contains cursor information and commit parameters. Maximum 1000 entries per request. |

***

### `Dropbox Get About Me`

Integration name: **DROPBOX\_GET\_ABOUT\_ME**

Tool to get information about the current user's Dropbox account. Use when you need to retrieve account details like email, name, or account type. Useful for verifying authenticated account identity before destructive operations in multi-account setups. Note: successful response does not imply access to all shared or team folders; path-specific permission errors from other tools indicate missing folder-level permissions, not empty results.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Get Account`

Integration name: **DROPBOX\_GET\_ACCOUNT**

Tool to get information about a user's Dropbox account using their account ID. Use when you need to retrieve account details for a specific user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                      | Description                                                                       |
| ------------ | ------ | :------: | -------------------------------------------- | --------------------------------------------------------------------------------- |
| `account_id` | string |     ✅    | `"dbid:AAAg6CG-fX-PFZBs5HJhXA9ULyesUj6f6h0"` | A user's account identifier. Can be obtained from get\_current\_account endpoint. |

***

### `Dropbox Get Account Batch`

Integration name: **DROPBOX\_GET\_ACCOUNT\_BATCH**

Tool to get information about multiple user accounts in a single request. At most 300 accounts may be queried per request. Use when you need to retrieve details for multiple Dropbox users efficiently.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type  | Required | Example                                        | Description                                                                                                       |
| ------------- | ----- | :------: | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `account_ids` | array |     ✅    | `["dbid:AAAg6CG-fX-PFZBs5HJhXA9ULyesUj6f6h0"]` | List of user account identifiers. Should not contain any duplicate account IDs. Maximum 300 accounts per request. |

***

### `Dropbox Get Available Team Member Roles`

Integration name: **DROPBOX\_GET\_AVAILABLE\_TEAM\_MEMBER\_ROLES**

Tool to retrieve all available team member roles for the connected Dropbox team. Use when you need to discover what roles can be assigned to team members (e.g., Team, Billing, Report, Content, Security, User management, Support).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Get Copy Reference`

Integration name: **DROPBOX\_GET\_COPY\_REFERENCE**

Tool to get a copy reference to a file or folder. Use when you need to generate a reference string that can be used to copy the file or folder to another user's Dropbox via copy\_reference/save.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example       | Description                                                                                      |
| --------- | ------ | :------: | ------------- | ------------------------------------------------------------------------------------------------ |
| `path`    | string |     ✅    | `"/test.txt"` | The path to the file or folder you want to get a copy reference to. This path is case-sensitive. |

***

### `Dropbox Get File Lock Batch`

Integration name: **DROPBOX\_GET\_FILE\_LOCK\_BATCH**

Tool to return lock metadata for multiple files in a single batch request. Use when you need to check the lock status of up to 1000 files at once.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                               |
| --------- | ----- | :------: | ------- | ------------------------------------------------------------------------- |
| `entries` | array |     ✅    | —       | List of files to check lock status for. Maximum 1000 entries per request. |

***

### `Dropbox Get File Metadata Batch`

Integration name: **DROPBOX\_GET\_FILE\_METADATA\_BATCH**

Tool to retrieve metadata for multiple shared files in a single batch request. Use when you need to get information about shared file permissions, access levels, owners, and sharing policies for multiple files at once.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                         | Description                                                                                                                                                                           |
| --------- | ----- | :------: | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `files`   | array |     ✅    | `["/Documents/report.pdf","/Photos/image.png"]` | List of files to query. Each can be a file ID (e.g., 'id:7bh4zBmgZoAAAAAAAAAAFg') or a path (e.g., '/path/to/file.txt'). Maximum 100 files per request.                               |
| `actions` | array |          | —                                               | A list of FileActions corresponding to FilePermissions that should appear in the response's permissions field describing the actions the authenticated user can perform on the files. |

***

### `Dropbox Get File Preview`

Integration name: **DROPBOX\_GET\_FILE\_PREVIEW**

Tool to get a preview for a file. PDF previews are generated for document formats (.ai, .doc, .docx, .eps, .ppt, .pptx, etc.), and HTML previews are generated for spreadsheet formats (.csv, .xls, .xlsx, etc.). Use when you need to view file content without downloading the original file. Returns error for unsupported file types.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                    | Description                                                                                                                                                                                                                                   |
| --------- | ------ | :------: | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`    | string |     ✅    | `"/Documents/report.docx"` | The path of the file to preview. Supported preview formats: PDF previews (.ai, .doc, .docm, .docx, .eps, .gdoc, .gslides, .odp, .odt, .pps, .ppsm, .ppsx, .ppt, .pptm, .pptx, .rtf); HTML previews (.csv, .ods, .xls, .xlsm, .gsheet, .xlsx). |

***

### `Dropbox Get File Request`

Integration name: **DROPBOX\_GET\_FILE\_REQUEST**

Tool to retrieve details of an existing file request by ID. Use when you need to check the status, URL, deadline, or other details of a specific file request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                  | Description                             |
| --------- | ------ | :------: | ------------------------ | --------------------------------------- |
| `id`      | string |     ✅    | `"mi5NYsiwUIS6sYwhEeDS"` | The ID of the file request to retrieve. |

***

### `Dropbox Get File Tags`

Integration name: **DROPBOX\_GET\_FILE\_TAGS**

Tool to get list of tags assigned to files or folders in Dropbox. Use when you need to retrieve tags for one or more items. This endpoint does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example         | Description                                                                                                                              |
| --------- | ----- | :------: | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `paths`   | array |     ✅    | `["/test.txt"]` | List of file or folder paths to get tags for (e.g., \["/Documents/report.pdf", "/Photos/image.jpg"]). Maximum of 1000 paths per request. |

***

### `Dropbox Get Folder Cursor`

Integration name: **DROPBOX\_GET\_FOLDER\_CURSOR**

Tool to get a cursor representing the current state of a folder without listing its contents. Use when you only need to track future changes to a folder, not retrieve existing files. This is more efficient than list\_folder for setting up change monitoring or sync functionality.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                             | Type    | Required | Example | Description                                                                                                                                            |
| ------------------------------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `path`                                | string  |          | `""`    | The path to the folder. Use "" (empty string) for the root folder, or a path like "/folder/subfolder". Also accepts folder IDs (e.g., "id:abc123xyz"). |
| `limit`                               | integer |          | —       | The maximum number of results to return per request when using this cursor with list\_folder/continue. If not specified, the API uses a default.       |
| `recursive`                           | boolean |          | —       | If true, the cursor will include all subfolders and their contents recursively. If false, only the immediate contents are tracked.                     |
| `shared_link`                         | object  |          | —       | Shared link information for listing folder contents.                                                                                                   |
| `include_deleted`                     | boolean |          | —       | If true, deleted files and folders will be included when using this cursor to track changes.                                                           |
| `include_media_info`                  | boolean |          | —       | If true, media metadata (dimensions, location, etc.) will be included for photo and video files when using this cursor.                                |
| `include_mounted_folders`             | boolean |          | —       | If true, results will include entries under mounted folders (app folders, shared folders, team folders).                                               |
| `include_property_groups`             | object  |          | —       | Template filter for property groups.                                                                                                                   |
| `include_has_explicit_shared_members` | boolean |          | —       | If true, results will include a flag indicating whether each file or folder has explicit shared members.                                               |

***

### `Dropbox Get Jwks`

Integration name: **DROPBOX\_GET\_JWKS**

Tool to retrieve JSON Web Key Set containing public verification keys for Dropbox signed ID tokens. Use when you need to verify JWT signatures from Dropbox OpenID Connect authentication.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Get Metadata`

Integration name: **DROPBOX\_GET\_METADATA**

Tool to fetch metadata for a file or folder by path. Use when you need to verify existence, get canonical identifiers (id, path\_display), determine type (.tag), or retrieve detailed attributes without enumerating folder contents.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                             | Type    | Required | Example                   | Description                                                                                                                                   |
| ------------------------------------- | ------- | :------: | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`                                | string  |     ✅    | `"/Documents/report.pdf"` | The path of a file or folder on Dropbox (e.g., "/Documents/report.pdf"). Note: The root folder ("" or "/") is not supported by this endpoint. |
| `include_deleted`                     | boolean |          | —                         | If true, DeletedMetadata will be returned for deleted files or folders. Otherwise, deleted items will return an error.                        |
| `include_media_info`                  | boolean |          | —                         | If true, FileMetadata.media\_info is set for photo and video files, providing additional metadata like dimensions and location.               |
| `include_has_explicit_shared_members` | boolean |          | —                         | If true, the result will include a flag indicating whether the file has any explicit shared members.                                          |

***

### `Dropbox Get Metadata Alpha`

Integration name: **DROPBOX\_GET\_METADATA\_ALPHA**

Tool to fetch metadata for a file or folder using the alpha endpoint. Use when you need metadata with advanced property filtering or custom property template support.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                             | Type    | Required | Example                   | Description                                                                                                                     |
| ------------------------------------- | ------- | :------: | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `path`                                | string  |     ✅    | `"/Documents/report.pdf"` | The path of a file or folder on Dropbox (e.g., "/Documents/report.pdf"). Use "" or "/" for the root folder.                     |
| `include_deleted`                     | boolean |          | —                         | If true, DeletedMetadata will be returned for deleted files or folders. Otherwise, deleted items will return an error.          |
| `include_media_info`                  | boolean |          | —                         | If true, FileMetadata.media\_info is set for photo and video files, providing additional metadata like dimensions and location. |
| `include_property_groups`             | object  |          | —                         | Filter for property template IDs.                                                                                               |
| `include_has_explicit_shared_members` | boolean |          | —                         | If true, the result will include a flag indicating whether the file has any explicit shared members.                            |

***

### `Dropbox Get Openid Config`

Integration name: **DROPBOX\_GET\_OPENID\_CONFIG**

Tool to retrieve Dropbox's OpenID Connect discovery document describing supported OAuth 2.0 and OIDC parameters. Use when you need to discover Dropbox's OAuth configuration endpoints and capabilities.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Get Shared File Metadata`

Integration name: **DROPBOX\_GET\_SHARED\_FILE\_METADATA**

Tool to retrieve metadata for a shared file in Dropbox. Use when you need to get information about a shared file's permissions, access levels, owner, and sharing policies.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                       | Description                                                                                                                                                                          |
| --------- | ------ | :------: | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `file`    | string |     ✅    | `"id:7bh4zBmgZoAAAAAAAAAAFg"` | The file to query. Can be a file ID (e.g., 'id:7bh4zBmgZoAAAAAAAAAAFg') or a path.                                                                                                   |
| `actions` | array  |          | —                             | A list of FileActions corresponding to FilePermissions that should appear in the response's permissions field describing the actions the authenticated user can perform on the file. |

***

### `Dropbox Get Shared Folder Metadata`

Integration name: **DROPBOX\_GET\_SHARED\_FOLDER\_METADATA**

Tool to retrieve metadata for a specific shared folder by its ID. Use when you need detailed information about a shared folder including access level, policies, owner, paths, and permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example         | Description                                                                                                                                                                               |
| ------------------ | ------ | :------: | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `actions`          | array  |          | —               | A list of FolderActions corresponding to FolderPermissions that should appear in the response's permissions field describing the actions the authenticated user can perform on the folder |
| `shared_folder_id` | string |     ✅    | `"84528192421"` | The ID for the shared folder                                                                                                                                                              |

***

### `Dropbox Get Shared Link File`

Integration name: **DROPBOX\_GET\_SHARED\_LINK\_FILE**

Tool to download a file from a Dropbox shared link. Use when you have a shared link URL and need to retrieve the actual file content. This endpoint works with shared links to files; for shared links to folders, use the path parameter to specify which file within the folder to download.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                                              | Description                                                                                                                                       |
| --------------- | ------ | :------: | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`           | string |     ✅    | `"https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0"` | URL of the shared link to download the file from.                                                                                                 |
| `path`          | string |          | `"/subfolder/file.txt"`                                              | If the shared link is to a folder, this parameter can be used to retrieve a specific file or sub-folder in this folder. Path must start with '/'. |
| `link_password` | string |          | —                                                                    | If the shared link has a password, this parameter can be used to provide it.                                                                      |

***

### `Dropbox Get Shared Link Metadata`

Integration name: **DROPBOX\_GET\_SHARED\_LINK\_METADATA**

Tool to resolve a Dropbox shared link URL into structured metadata. Use when the user provides a shared link and you need to determine what it points to (file vs folder) and obtain canonical identifiers (id, path) to enable follow-on operations.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                                              | Description                                                                                                                                                          |
| --------------- | ------ | :------: | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`           | string |     ✅    | `"https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0"` | The shared link URL to retrieve metadata for.                                                                                                                        |
| `path`          | string |          | `"/subfolder"`                                                       | If the shared link is to a folder, this parameter can be used to retrieve metadata for a specific file or sub-folder in this folder. A relative path should be used. |
| `link_password` | string |          | —                                                                    | If the shared link has a password, this parameter can be used to provide it.                                                                                         |

***

### `Dropbox Get Space Usage`

Integration name: **DROPBOX\_GET\_SPACE\_USAGE**

Tool to get space usage information for the current user's Dropbox account. Use when you need to check storage usage, available space, or quota information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Get Team Feature Values`

Integration name: **DROPBOX\_GET\_TEAM\_FEATURE\_VALUES**

Tool to get values for one or more team features. Use when you need to check team capabilities like upload rate limits, shared team root availability, file events, or selective sync status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type  | Required | Example                               | Description                                                                                                                                                                                                         |
| ---------- | ----- | :------: | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `features` | array |     ✅    | `[{"tag":"has_team_shared_dropbox"}]` | A list of features to get values for. At least one feature must be included. Available features: 'upload\_api\_rate\_limit', 'has\_team\_shared\_dropbox', 'has\_team\_file\_events', 'has\_team\_selective\_sync'. |

***

### `Dropbox Get Team Folder Info`

Integration name: **DROPBOX\_GET\_TEAM\_FOLDER\_INFO**

Tool to retrieve metadata for team folders. Returns information about folder status, sync settings, and properties for the specified team folder IDs. Use when you need to check the status or configuration of one or more team folders.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type  | Required | Example                            | Description                                                                         |
| ----------------- | ----- | :------: | ---------------------------------- | ----------------------------------------------------------------------------------- |
| `team_folder_ids` | array |     ✅    | `["947182","5819424","852307532"]` | The list of team folder IDs to retrieve metadata for. Must contain at least one ID. |

***

### `Dropbox Get Team Groups Info`

Integration name: **DROPBOX\_GET\_TEAM\_GROUPS\_INFO**

Tool to retrieve information about one or more team groups by their IDs or external IDs. Use when you need to get details about specific groups including name, member count, management type, and creation time.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example                                  | Description                                                                                                                                                              |
| -------------------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `group_ids`          | array  |          | `["g:e18cdeb8c1e9c0280000000000000053"]` | List of Dropbox group IDs. Required when selector\_type is 'group\_ids'. Example: \['g:e18cdeb8c1e9c0280000000000000053', 'g:e18cdeb8c1e9c0280000000000000054']          |
| `selector_type`      | string |     ✅    | `"group_ids"`                            | The type of selector to use for identifying groups. 'group\_ids' - Select groups by Dropbox group IDs. 'group\_external\_ids' - Select groups by external IDs.           |
| `group_external_ids` | array  |          | —                                        | List of external group IDs. Required when selector\_type is 'group\_external\_ids'. These are IDs from an external system that have been associated with Dropbox groups. |

***

### `Dropbox Get Team Groups Job Status`

Integration name: **DROPBOX\_GET\_TEAM\_GROUPS\_JOB\_STATUS**

Tool to check the status of an asynchronous team groups job in Dropbox. Use when you have an async\_job\_id from a previous team groups operation (like groups\_delete) and need to poll its completion status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                   | Description                                                                                                                                   |
| -------------- | ------ | :------: | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AABqMA6RIxE3E6A"` | Id of the asynchronous job. This is the value of a response returned from the method that launched the job (e.g., from team\_groups\_delete). |

***

### `Dropbox Get Team Info`

Integration name: **DROPBOX\_GET\_TEAM\_INFO**

Tool to retrieve information about a Dropbox team. Use when you need to get team details such as team name, ID, licensed user counts, or team policies.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Get Team Log Events`

Integration name: **DROPBOX\_GET\_TEAM\_LOG\_EVENTS**

Tool to retrieve team audit log events from Dropbox. Use when you need to access team activity logs, audit trails, or monitor team events. Supports filtering by time range and event category, with pagination for large result sets.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example | Description                                                                                                                                                                                                           |
| ---------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `time`     | object  |          | —       | Time range filter for events.                                                                                                                                                                                         |
| `limit`    | integer |          | —       | Maximum number of events to return per request. Default is 1000, maximum is 1000.                                                                                                                                     |
| `cursor`   | string  |          | —       | Cursor for pagination, obtained from a previous response. Use this to retrieve the next page of results.                                                                                                              |
| `category` | string  |          | —       | Event category filter to limit results (e.g., 'apps', 'devices', 'domains', 'file\_operations', 'file\_requests', 'groups', 'logins', 'members', 'paper', 'passwords', 'sharing', 'team\_folders', 'team\_policies'). |

***

### `Dropbox Get Team Log Events Continue`

Integration name: **DROPBOX\_GET\_TEAM\_LOG\_EVENTS\_CONTINUE**

Tool to paginate through team audit log events using a cursor from team\_log/get\_events. Use when you have a cursor from a previous call and need to retrieve the next batch of team events.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                                                                                                                                                                                 | Description                                                                                                                                                 |
| --------- | ------ | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AAP6SdLPJYCLd3O11Q0JTGW5Ms0gcC66rNdX-AF2kuxmLfnodmK97xxVMp9xUp2K2-ewsj8OEdF5LPo18wSGVQlA1PfuxP7F1cajKhsXPEHQRVx6homquXLCA1qCsR18Mcwg_1BFs6EvxELlhvIZUWOfuD33pBdZ_QSrgRzfVKh7sborjnoh-s_HAPDA4TTH8oFm43YnSP0mPS2MQOYDottqWqDeFw6FwmPTupLCfzKCjACvXQFT747K5UCLsMeaokUvjOSrVZyVo5qXiFx6mOhQsRYZTrSBMJ-NQy7sa7i8pqiRSRkJ590oqjVJeqhwNTwvTB5fdiSs6TVo95zknKUGVfi0mymG21WDhvlto93rtt4fKqYQCEE4d3GtaUcAFuU"` | The cursor returned by a previous call to team\_log/get\_events or team\_log/get\_events/continue. This cursor is used to paginate through all team events. |

***

### `Dropbox Get Team Member Custom Quota`

Integration name: **DROPBOX\_GET\_TEAM\_MEMBER\_CUSTOM\_QUOTA**

Tool to retrieve custom storage quotas for team members. Use when you need to check which team members have custom quota allocations and their quota amounts. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                                                                    | Description                                                                                                                                                                                                                                      |
| --------- | ----- | :------: | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `users`   | array |          | `[{".tag":"team_member_id","team_member_id":"dbmid:AACwJ2ojytbXGFyiUs6_0Py3GqOt2LyicSg"}]` | List of team member identifiers to retrieve custom quota for. Each member must be identified by exactly one of: team\_member\_id, external\_id, or email. Maximum of 1000 users per request. An empty list returns all users with custom quotas. |

***

### `Dropbox Get Team Members Add Job Status`

Integration name: **DROPBOX\_GET\_TEAM\_MEMBERS\_ADD\_JOB\_STATUS**

Tool to poll the status of an asynchronous team member addition job. Use when you have an async\_job\_id from team/members/add\_v2 and need to check if the member addition has completed. Returns 'in\_progress', 'complete' with per-member results, or 'failed' with error details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                            | Description                                                                                                                 |
| -------------- | ------ | :------: | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `async_job_id` | string |     ✅    | `"dbjid:AABxv50qC1yK7PO_ZBHJJo9fx233_sEGTeTyfXpzbdkfDpNf9Ry3ZtSMr237ybOTkPMahsSBohIiRm948EcJ0FGj"` | Id of the asynchronous job returned from team/members/add\_v2. This is used to poll the status of the asynchronous request. |

***

### `Dropbox Get Team Members Info`

Integration name: **DROPBOX\_GET\_TEAM\_MEMBERS\_INFO**

Tool to retrieve information about multiple team members in a single request. Use when you need to get details like email, name, status, role, and account information for one or more team members. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example                                                                                    | Description                                                                                                                                              |
| --------- | ----- | :------: | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `members` | array |     ✅    | `[{".tag":"team_member_id","team_member_id":"dbmid:AACwJ2ojytbXGFyiUs6_0Py3GqOt2LyicSg"}]` | List of team member identifiers to retrieve information for. Each member must be identified by exactly one of: team\_member\_id, external\_id, or email. |

***

### `Dropbox Get Team Properties Template`

Integration name: **DROPBOX\_GET\_TEAM\_PROPERTIES\_TEMPLATE**

Tool to get the schema for a specified property template for a team. Use when you need to retrieve the structure and field definitions of a team property template.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                         | Description                                                                                                                             |
| ------------- | ------ | :------: | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `template_id` | string |     ✅    | `"ptid:4YzeuMHpwCgAAAAAAAAAPQ"` | An identifier for a template added by route templates/add\_for\_user or templates/add\_for\_team. Typically in the format 'ptid:XXXXX'. |

***

### `Dropbox Get Temporary Link`

Integration name: **DROPBOX\_GET\_TEMPORARY\_LINK**

Tool to get a one-click temporary (expiring) download link. Use when you need to share a Dropbox file directly without proxying content through this service. Only works for files, not folders. Returned URLs expire within hours and must be regenerated for future use; never treat them as permanent links. Requires `files.content.read` scope.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                              | Description                                                                                                                                            |
| --------- | ------ | :------: | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `path`    | string |     ✅    | `"/Homework/math/Prime_Numbers.txt"` | The path or identifier of the file to get a temporary link for. Supports Dropbox path (e.g., '/folder/file.txt'), id:..., rev:..., or ns:... notation. |

***

### `Dropbox Get Temporary Upload Link`

Integration name: **DROPBOX\_GET\_TEMPORARY\_UPLOAD\_LINK**

Tool to get a one-time use temporary upload link to upload a file to Dropbox. Use when you need to perform a delayed upload where the file will be uploaded to the returned link via POST with Content-Type: application/octet-stream. The upload link is valid for up to 4 hours.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                                           |
| ------------- | ------- | :------: | ------- | --------------------------------------------------------------------- |
| `duration`    | integer |          | `3600`  | Link validity period in seconds. Maximum is 4 hours (14400 seconds).  |
| `commit_info` | object  |     ✅    | —       | Upload configuration specifying destination path and upload behavior. |

***

### `Dropbox Get Thumbnail`

Integration name: **DROPBOX\_GET\_THUMBNAIL**

Tool to get a thumbnail for an image file. Use when you need to generate a thumbnail preview of an image. Supports jpg, jpeg, png, tiff, tif, gif, webp, ppm, and bmp files under 20MB.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                  | Description                                                                                                                                                                                                              |
| --------- | ------ | :------: | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `mode`    | string |          | —                        | How to resize and crop the image. 'strict': scale down to fit within the given size. 'bestfit': scale down to fit within size or its transpose. 'fitone\_bestfit': scale down to completely cover size or its transpose. |
| `path`    | string |     ✅    | `"/Photos/vacation.jpg"` | The path to the image file you want to thumbnail. Must start with '/'.                                                                                                                                                   |
| `size`    | string |          | —                        | The size for the thumbnail image. Options range from 32x32 pixels to 2048x1536 pixels.                                                                                                                                   |
| `format`  | string |          | —                        | The format for the thumbnail image. Use 'jpeg' for photos (default), 'png' for screenshots and digital arts.                                                                                                             |

***

### `Dropbox Get Thumbnail Batch`

Integration name: **DROPBOX\_GET\_THUMBNAIL\_BATCH**

Tool to get thumbnails for multiple image files in a single batch request. Use when you need to generate thumbnail previews for up to 25 images at once. Supports jpg, jpeg, png, tiff, tif, gif, webp, ppm, and bmp files under 20MB.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                          |
| --------- | ----- | :------: | ------- | -------------------------------------------------------------------- |
| `entries` | array |     ✅    | —       | List of files to get thumbnails for. Maximum 25 entries per request. |

***

### `Dropbox Get Thumbnail V2`

Integration name: **DROPBOX\_GET\_THUMBNAIL\_V2**

Tool to get a thumbnail for an image file. Use when you need to generate a thumbnail preview of an image. Supports jpg, jpeg, png, tiff, tif, gif, webp, ppm, and bmp files under 20MB. Can access files via direct path or shared link.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                             | Description                                                                                                                                                                                                              |
| --------------- | ------ | :------: | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `url`           | string |          | `"https://www.dropbox.com/s/abc123/image.jpg?dl=0"` | The shared link URL (required when resource\_type is 'link').                                                                                                                                                            |
| `mode`          | string |          | —                                                   | How to resize and crop the image. 'strict': scale down to fit within the given size. 'bestfit': scale down to fit within size or its transpose. 'fitone\_bestfit': scale down to completely cover size or its transpose. |
| `path`          | string |          | `"/Photos/vacation.jpg"`                            | The path to the image file (required when resource\_type is 'path'). Must start with '/'.                                                                                                                                |
| `size`          | string |          | —                                                   | The size for the thumbnail image. Options range from 32x32 pixels to 2048x1536 pixels.                                                                                                                                   |
| `format`        | string |          | —                                                   | The format for the thumbnail image. Use 'jpeg' for photos, 'png' for screenshots and digital arts.                                                                                                                       |
| `link_path`     | string |          | —                                                   | Optional relative path within shared folder (only used with resource\_type='link' when link points to a folder).                                                                                                         |
| `resource_type` | string |     ✅    | —                                                   | Type of resource: 'path' for direct file path or 'link' for shared link.                                                                                                                                                 |

***

### `Dropbox Get User Features`

Integration name: **DROPBOX\_GET\_USER\_FEATURES**

Tool to get a list of feature values configured for the current Dropbox account. Use when you need to check which features are enabled, such as paper\_as\_files or file\_locking.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type  | Required | Example                                             | Description                                                                                                                                                                                        |
| ---------- | ----- | :------: | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `features` | array |     ✅    | `[{"tag":"paper_as_files"},{"tag":"file_locking"}]` | A list of features to get values for. Available features: 'paper\_as\_files' (information about how Paper files are stored), 'file\_locking' (whether users can lock files in shared directories). |

***

### `Dropbox List Excluded Users Continue`

Integration name: **DROPBOX\_LIST\_EXCLUDED\_USERS\_CONTINUE**

Tool to paginate through team members excluded from space limits using a cursor from a previous list call. Use when you have a cursor from the initial excluded users list endpoint and need to retrieve the next batch of excluded team members.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                            | Description                                                                                                                                                                                                                                                                                         |
| --------- | ------ | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AAbfs_7ExsNYasJr9Y4iFlAbSetz6vpWVR0G3_k1gb6dMOpMGO4DUUYQ7yUcGGCFT0wZv_PE6cgGIoetyVvRR7cV5nW7WcRf3vmmt4V8if8OcpdBjr_ifZspHgftt3nOj7aTmZ-rnBfprgGvfaD4YgcuT80vskf8FYrJPWMaSGLd2Z520mqgBgyL8Cjd_FyAM5F0plBaBkw6e73Yf_iounqN-dworDeDyzxjkoKnM2QA4Q"` | The cursor returned by a previous call to list member space limits excluded users. This cursor is used to paginate through all excluded users. Must come from a previous call to /2/team/member\_space\_limits/excluded\_users/list or /2/team/member\_space\_limits/excluded\_users/list/continue. |

***

### `Dropbox List File Members`

Integration name: **DROPBOX\_LIST\_FILE\_MEMBERS**

Tool to obtain the members who have been invited to a file, both inherited and uninherited members. Use when you need to retrieve detailed information about users, groups, and invitees with access to a specific file, including their access levels and permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                       | Description                                                                                                                                                                    |
| ------------------- | ------- | :------: | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `file`              | string  |     ✅    | `"id:3kmLmQFnf1AAAAAAAAAAAw"` | The file for which you want to see members. Can be a file ID (starting with 'id:') or a file path (starting with '/').                                                         |
| `limit`             | integer |          | —                             | Number of members to return max per query. Must be between 1 and 300.                                                                                                          |
| `actions`           | array   |          | `["make_editor","remove"]`    | The actions for which to return permissions on a member. Valid values: 'leave\_a\_copy', 'make\_editor', 'make\_owner', 'make\_viewer', 'make\_viewer\_no\_comment', 'remove'. |
| `include_inherited` | boolean |          | —                             | Whether to include members who only have access from a parent shared folder. Defaults to true.                                                                                 |

***

### `Dropbox List File Members Batch`

Integration name: **DROPBOX\_LIST\_FILE\_MEMBERS\_BATCH**

Tool to get members of multiple files at once. Use when you need to retrieve sharing information for multiple files in a single request. Returns users, groups, and invitees with access to each file, but does not include inherited members or detailed permissions. For more detailed results, use the individual file member endpoint.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example                                    | Description                                                                                                                           |
| --------- | ------- | :------: | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `files`   | array   |     ✅    | `["id:abc123xyz","/Documents/report.pdf"]` | Files for which to return members. Can be file IDs (starting with 'id:') or paths (starting with '/'). Maximum 100 files per request. |
| `limit`   | integer |          | —                                          | Number of members to return max per query per file. Defaults to 10 if not specified. Maximum 20.                                      |

***

### `Dropbox List File Requests`

Integration name: **DROPBOX\_LIST\_FILE\_REQUESTS**

Tool to list all file requests owned by the current user. Use when you need to see existing file requests, their status, and details.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                               |
| --------- | ------- | :------: | ------- | --------------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of file requests to return. Default: 1000. |

***

### `Dropbox List File Requests Continue`

Integration name: **DROPBOX\_LIST\_FILE\_REQUESTS\_CONTINUE**

Tool to paginate through file requests using a cursor from a previous list call. Use when you have a cursor from /2/file\_requests/list or /2/file\_requests/list/continue and need to retrieve the next batch of file requests.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                   | Description                                                                                                                                                                                                           |
| --------- | ------ | :------: | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"` | The cursor returned by a previous call to list file requests. This cursor is used to paginate through all file requests. Must come from a previous call to /2/file\_requests/list or /2/file\_requests/list/continue. |

***

### `Dropbox List File Revisions`

Integration name: **DROPBOX\_LIST\_FILE\_REVISIONS**

Tool to retrieve the revision history for a file. Use when you need to see past versions of a file, restore a previous version, or track changes over time.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example                   | Description                                                                                                                  |
| --------- | ------- | :------: | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `mode`    | object  |          | —                         | Mode for listing revisions.                                                                                                  |
| `path`    | string  |     ✅    | `"/Documents/report.pdf"` | The path to the file you want to see the revisions of (e.g., "/Documents/report.pdf"). Must be a valid file path in Dropbox. |
| `limit`   | integer |          | —                         | The maximum number of revision entries returned. Default is 10, minimum is 1, maximum is 100.                                |

***

### `Dropbox List Files In Folder`

Integration name: **DROPBOX\_LIST\_FILES\_IN\_FOLDER**

Tool to list files and folders in a specified Dropbox directory. Use when you need to see the contents of a folder, including subfolders if recursive is true. When the response contains `has_more=true`, continue fetching with the returned cursor until `has_more=false` — stopping early misses entries in large folders. Response entries include both files and folders; use the `.tag` field on each entry to distinguish item types.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                        | Type    | Required | Example | Description                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `path`                           | string  |          | —       | The folder path (e.g., "/europe/invoices") or folder ID (e.g., "id:aBcDeFgH123") to list contents from. Use "" (empty string) for the root folder. No trailing slashes or whitespace allowed — malformed paths can silently produce empty results. Prefer paths from `path_display` or `path_lower` fields in prior API responses over manually constructed paths. |
| `limit`                          | integer |          | —       | The maximum number of results to return per request. Default is 2000. Max is 2000.                                                                                                                                                                                                                                                                                 |
| `recursive`                      | boolean |          | —       | If true, recursively lists contents of nested subfolders; otherwise, lists only immediate contents. Large or broad folder trees with recursive=true can produce very large responses and high latency; use only when full hierarchy is explicitly needed.                                                                                                          |
| `include_deleted`                | boolean |          | —       | If true, includes deleted (but potentially recoverable) files and folders in the listing.                                                                                                                                                                                                                                                                          |
| `include_media_info`             | boolean |          | —       | If true, includes media metadata (e.g., dimensions, location) for photo and video files.                                                                                                                                                                                                                                                                           |
| `include_non_downloadable_files` | boolean |          | —       | If true, includes non-downloadable files (e.g., Google Docs, Dropbox Paper) in the listing.                                                                                                                                                                                                                                                                        |

***

### `Dropbox List Folder Continue`

Integration name: **DROPBOX\_LIST\_FOLDER\_CONTINUE**

Tool to continue paginating through folder contents using a cursor from list\_folder. Use when has\_more is true to retrieve remaining entries.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                    | Description                                                                                                                                                |
| --------- | ------ | :------: | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"your_cursor_token_here"` | The cursor returned by your last call to list\_folder or list\_folder/continue. Use this to paginate through all files and retrieve updates to the folder. |

***

### `Dropbox List Folder Members`

Integration name: **DROPBOX\_LIST\_FOLDER\_MEMBERS**

Tool to list members of a shared folder, including users, groups, and invitees. Use when you need to retrieve information about who has access to a specific shared folder and their permission levels.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example         | Description                                                                                                                                                                                                                                                            |
| ------------------ | ------- | :------: | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`            | integer |          | —               | The maximum number of results that include members, groups and invitees to return per request                                                                                                                                                                          |
| `actions`          | array   |          | —               | List indicating whether each returned member will include a boolean value showing if the current user can perform the MemberAction on the member. Valid values: 'leave\_a\_copy', 'make\_editor', 'make\_owner', 'make\_viewer', 'make\_viewer\_no\_comment', 'remove' |
| `shared_folder_id` | string  |     ✅    | `"84528192421"` | The ID for the shared folder                                                                                                                                                                                                                                           |

***

### `Dropbox List Folder Members Continue`

Integration name: **DROPBOX\_LIST\_FOLDER\_MEMBERS\_CONTINUE**

Tool to continue paginating through shared folder members using a cursor from list\_folder\_members. Use when cursor is present in list\_folder\_members response to retrieve remaining member entries.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                            | Description                                                                                                                                               |
| --------- | ------ | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AhHdpP3yi-6qOSoY_epBXgEbKTbPQ3BidBe5QX2mfv90FCC_rR__814MZb3yBrSkHqwyVUo9mwjqGbkxCsDwnfqCTmsaA5vLEXYexqNx6puKy3ZGQtNFdPJsLeq9QITY9NFTBs4Dnke6-Lm74jmHPpQm0FUBT_tTW30cjP7yv-ONdw"` | The cursor returned by your last call to list\_folder\_members or list\_folder\_members/continue. Use this to paginate through all shared folder members. |

***

### `Dropbox List Folders`

Integration name: **DROPBOX\_LIST\_FOLDERS**

DEPRECATED: Use ListFilesInFolder instead. Retrieves a list of folders, files, and deleted entries from a specified Dropbox path.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example | Description                                                                                                                                                                                                                     |
| ----------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`            | string  |          | —       | Path to the folder (e.g., "" for root, "/folder/subfolder", or "id:abc123xyz"). If a path string, it must start with / and not end with / or whitespace.                                                                        |
| `limit`           | integer |          | —       | Maximum number of folder entries to return per request; an approximate upper bound.                                                                                                                                             |
| `recursive`       | boolean |          | —       | Whether to include folders in nested subfolders (True) or only immediate subfolders (False) Combining with a high `limit` or broad `path` can yield very large responses; scope `path` narrowly to keep result sets manageable. |
| `include_deleted` | boolean |          | —       | Whether to include folders that have been deleted but may be recoverable                                                                                                                                                        |

***

### `Dropbox List Folders Continue`

Integration name: **DROPBOX\_LIST\_FOLDERS\_CONTINUE**

Tool to continue paginating through shared folders using a cursor from list\_folders. Use when the cursor is present in list\_folders response to retrieve remaining shared folder entries.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                            | Description                                                                                                                           |
| --------- | ------ | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AhEZoCTVobpJ50FL9o65wOvibCEMRe8vuB4Qf-5GzuHNpvqavj4GzN3qfZBcHPiqRdSFAgjbLmA58TWgikdObP1Egk2HOLsEXtlAkWjOLbEyYI9XRqIBHM8Hdl-r-DGJeCDG01JFxQqGdfYDh_ZZx1RTRRHzVoQXMLH3oHJqpo7O0IvYlTKxSfesfY1SLuEllK-ngYDCRNvn0tytM2DM7tGP02s_FWcXV_N7Ak9IMCj1Hw"` | The cursor returned by the previous call to list\_folders or list\_folders/continue. Use this to paginate through all shared folders. |

***

### `Dropbox List Member Linked Apps`

Integration name: **DROPBOX\_LIST\_MEMBER\_LINKED\_APPS**

Tool to list all applications linked to a specific team member's account. Use when you need to audit or review which third-party applications have been authorized by a particular team member.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                                       | Description                                                          |
| ---------------- | ------ | :------: | --------------------------------------------- | -------------------------------------------------------------------- |
| `team_member_id` | string |     ✅    | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | The team member ID. Can be obtained from team/members/list endpoint. |

***

### `Dropbox List Member Space Limits Excluded Users`

Integration name: **DROPBOX\_LIST\_MEMBER\_SPACE\_LIMITS\_EXCLUDED\_USERS**

Tool to list team members excluded from space limits. Use when you need to view which users are exempt from storage quotas. This is a team-level operation requiring team admin authentication.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                  |
| --------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Number of results to return per call. If not specified, all excluded users will be returned. |

***

### `Dropbox List Mountable Folders`

Integration name: **DROPBOX\_LIST\_MOUNTABLE\_FOLDERS**

Tool to list all shared folders the current user can mount or unmount. Use when discovering mountable shared folders (unmounted folders can be identified by absence of path\_lower field). This endpoint does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                                                                    |
| --------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of mountable folders to return per request. If not specified, the API will use its default limit.                                                                                               |
| `actions` | array   |          | —       | List of FolderActions corresponding to FolderPermissions that should appear in the response's SharedFolderMetadata.permissions field, describing the actions the authenticated user can perform on the folder. |

***

### `Dropbox List Mountable Folders Continue`

Integration name: **DROPBOX\_LIST\_MOUNTABLE\_FOLDERS\_CONTINUE**

Tool to paginate through mountable shared folders using a cursor. Use when you have a cursor from a previous call to list\_mountable\_folders or list\_mountable\_folders/continue and need to retrieve the next batch of folders.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                            | Description                                                                                                                                                         |
| --------- | ------ | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AhFFlnMhPWwceCrpaXF0ifpPl0fjff8G3VN7SqR0RT-xlD1qPgBypIZPneBv5QYQ0bT_rYaz7avfSjdk_fVdmgPCMlx5j0QWoKik4rnCfDkc-dW3JmlJGQwMNB4Mh4ZPcGxm_9BYgREmcPOVmjUwvulqa3mY7XY97ixvun0oYRMuIMFFPTp3XWFxns_8FX-dXAbVmlHI5G5UlzitPS4K6UaoDiw9eubAEClOdryO25mh9Q"` | The cursor returned by a previous call to list\_mountable\_folders or list\_mountable\_folders/continue. Use this to paginate through all mountable shared folders. |

***

### `Dropbox List Paper Docs`

Integration name: **DROPBOX\_LIST\_PAPER\_DOCS**

Tool to return the list of all Paper docs according to filter and sort specifications. Use when you need to retrieve Paper document IDs for further operations. To iterate through full pagination, pass the cursor to docs/list/continue.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example           | Description                                                                                                                                                                                                         |
| ------------ | ------- | :------: | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | `100`             | Size limit per batch. The maximum number of docs that can be retrieved per batch is 1000. Higher value results in invalid arguments error.                                                                          |
| `sort_by`    | string  |          | `"accessed"`      | Allows user to specify how the Paper docs should be sorted. 'accessed' sorts by last accessed time, 'modified' sorts by last modified time, 'created' sorts by creation time.                                       |
| `filter_by`  | string  |          | `"docs_accessed"` | Allows user to specify how the Paper docs should be filtered. 'docs\_accessed' fetches all Paper doc IDs that the user has ever accessed. 'docs\_created' fetches only the Paper doc IDs that the user has created. |
| `sort_order` | string  |          | `"ascending"`     | Allows user to specify the sort order of the result. 'ascending' sorts in ascending order, 'descending' sorts in descending order.                                                                                  |

***

### `Dropbox List Paper Docs Continue`

Integration name: **DROPBOX\_LIST\_PAPER\_DOCS\_CONTINUE**

Tool to continue paginating through Paper documents using a cursor from paper/docs/list. Use when has\_more is true to retrieve remaining Paper documents. Note: This endpoint continues to work for older Paper content; check user features to determine Paper version.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                    | Description                                                                                                              |
| --------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `cursor`  | string |     ✅    | `"your_cursor_token_here"` | The cursor obtained from paper/docs/list or paper/docs/list/continue. Allows for pagination through all Paper documents. |

***

### `Dropbox List Received Files`

Integration name: **DROPBOX\_LIST\_RECEIVED\_FILES**

Tool to list all files shared with the current user. Returns files directly shared with the user but does not include files received via shared folders or unclaimed invitations. Use when discovering files that have been shared with the authenticated user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                                                             |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Number of files to return max per query. Defaults to 100 if no limit is specified. Must be between 1 and 300.                                                                                           |
| `actions` | array   |          | —       | A list of FileActions corresponding to FilePermissions that should appear in the response's SharedFileMetadata.permissions field describing the actions the authenticated user can perform on the file. |

***

### `Dropbox List Shared Folders`

Integration name: **DROPBOX\_LIST\_SHARED\_FOLDERS**

Tool to list all shared folders the authenticated user has access to. Use when discovering shared or team-mounted folders that may not appear in a standard path listing. Returns metadata including folder name, ID, access level, and paths (if mounted).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                            |
| --------- | ------- | :------: | ------- | ------------------------------------------------------ |
| `limit`   | integer |          | —       | Maximum number of shared folders to return per request |

***

### `Dropbox List Shared Links`

Integration name: **DROPBOX\_LIST\_SHARED\_LINKS**

Tool to list existing shared links for the current user, optionally filtered by path. Use when you need to discover or reuse existing shared links to avoid creating duplicates or to check what links already exist for a file or folder. Supports pagination via cursor for large result sets.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example                   | Description                                                                                                                                                                                                                                                                                                    |
| ------------- | ------- | :------: | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`        | string  |          | `"/Documents/report.pdf"` | The path to the file or folder to list shared links for. If omitted, returns all shared links for the current user. If provided, returns links that grant access to the specified path (including parent folder links unless direct\_only is true). Supports Dropbox path notation (e.g., '/folder/file.txt'). |
| `cursor`      | string  |          | —                         | The cursor returned by a previous call to this endpoint. Use this to retrieve additional results when 'has\_more' is true. The API returns a maximum of \~200 links per call.                                                                                                                                  |
| `direct_only` | boolean |          | —                         | If true, only return direct links to the specified path. If false or omitted, also include links to parent folders. Only relevant when 'path' is specified.                                                                                                                                                    |

***

### `Dropbox List Sharing Allowlist`

Integration name: **DROPBOX\_LIST\_SHARING\_ALLOWLIST**

Tool to list Approve List entries for a team from newest to oldest. Use when you need to retrieve allowed domains and emails for team sharing.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                              |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------ |
| `limit`   | integer |          | —       | The number of entries to fetch at one time. Maximum and default is 1000. |

***

### `Dropbox List Team Devices`

Integration name: **DROPBOX\_LIST\_TEAM\_DEVICES**

Tool to list all device sessions of a team including web sessions, desktop clients, and mobile clients. Use when you need to audit team devices, view active sessions, or monitor device activity across the team. Supports pagination via cursor for large result sets. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example | Description                                                                                                                                                                                                                                                                 |
| ------------------------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`                  | string  |          | —       | Pagination cursor for retrieving additional results. At the first call to list\_team\_devices, the cursor shouldn't be passed. Then, if the result includes a cursor, subsequent requests should include the received cursor to retrieve the next sub-list of team devices. |
| `include_web_sessions`    | boolean |          | —       | Whether to list web sessions of the team members. If omitted, defaults to the API's default behavior.                                                                                                                                                                       |
| `include_mobile_clients`  | boolean |          | —       | Whether to list mobile clients of the team members. If omitted, defaults to the API's default behavior.                                                                                                                                                                     |
| `include_desktop_clients` | boolean |          | —       | Whether to list desktop clients of the team members. If omitted, defaults to the API's default behavior.                                                                                                                                                                    |

***

### `Dropbox List Team Folders`

Integration name: **DROPBOX\_LIST\_TEAM\_FOLDERS**

Tool to list all team folders for a Dropbox Business team. Use when you need to discover team-wide folders or manage team folder access.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                          |
| --------- | ------- | :------: | ------- | ---------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of team folders to return per request |

***

### `Dropbox List Team Folders Continue`

Integration name: **DROPBOX\_LIST\_TEAM\_FOLDERS\_CONTINUE**

Tool to continue paginating through team folders using a cursor from team\_folder/list. Use when the cursor is present in list\_team\_folders response to retrieve remaining team folder entries.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                                                                                                                                                                                 | Description                                                                                                                                 |
| --------- | ------ | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AAYRoi-7YM0zYifgbnQum--nG59C4L1PSpKO_ylWlTsNNoOiicBHi1SiNpwUdm14MA3b1tkfcuV9YLnCtAA1YrdM0naZh-3hYjdJD4v1ZadefpWLT31H8UZfD4MG6WdY24Js75GQ2k_vviHCKX3m-0-eN1Ye8yC385M80Zbs__dARmN5M7N3cfFhElxEDaBTAmmeBSISpJaKAr8zYP896-7NUL_15L0SESoa_mS_yuhIgQiBhN_7h4EC_6cw803oW9MOocR-dsdBzgxjyRVMIz-L_XPSjQ5zPhAtadFLFM-rIW_b9yY5t2jB-0_e9SPxeTtqGFw8ZmbkA5_T8p3GKd89hCAhbegnLj3jODbQewqr5pJh8zx3AM8eocv6AuP8sb0"` | The cursor returned by the previous call to team\_folder/list or team\_folder/list/continue. Use this to paginate through all team folders. |

***

### `Dropbox List Team Group Members`

Integration name: **DROPBOX\_LIST\_TEAM\_GROUP\_MEMBERS**

Tool to list members of a Dropbox team group. Use when you need to retrieve the list of team members who belong to a specific group. Returns member profiles with email, status, and access information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                                | Description                                                                                                                                                                  |
| ------------------- | ------- | :------: | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`             | integer |          | —                                      | Maximum number of members to return per request. Must be between 1 and 1000.                                                                                                 |
| `group_id`          | string  |          | `"g:e18cdeb8c1e9c0280000000000000003"` | The Dropbox group ID. Required when selector\_type is 'group\_id'. Example: 'g:e18cdeb8c1e9c0280000000000000003'                                                             |
| `selector_type`     | string  |     ✅    | `"group_id"`                           | The type of selector to use for identifying the group. 'group\_id' - Select group by Dropbox group ID. 'group\_external\_id' - Select group by external ID.                  |
| `group_external_id` | string  |          | —                                      | The external ID of the group. Required when selector\_type is 'group\_external\_id'. This is the ID from an external system that has been associated with the Dropbox group. |

***

### `Dropbox List Team Groups`

Integration name: **DROPBOX\_LIST\_TEAM\_GROUPS**

Tool to list all groups on a Dropbox team. Use when you need to see all team groups with their metadata including group ID, name, and member count.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                     |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Number of groups to return per call. If not specified, all groups are returned. |

***

### `Dropbox List Team Groups Continue`

Integration name: **DROPBOX\_LIST\_TEAM\_GROUPS\_CONTINUE**

Tool to continue listing team groups using a cursor from team/groups/list. Use when you have a cursor from a previous team groups list call and need to retrieve the next batch of groups.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                                                                                            | Description                                                                                       |
| --------- | ------ | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AAbFsrAxa8JoiIl-7rpL-xfxyoGJkL-QkqIWTUWbPqT-9PX1k-8IZTdXj5VqwkONNWl9mlETk4a8mLiWIjgK6U_XCjDviA9vWEpdzWiK3b-Ugxf00_3njNvATQ8e9ulYI2h_X5vCCLcrwFCkVIHz7tuesiZwn-sF4yWjcIhJDD4l_aUi6o8Tymo1mNp9BywmSpirekXQh5DFklNWfwWVk91WGkoakmN49rrcMgnCk4P1GsslDscc1H61T08OAeqTjPc63lx0CndG-L1E-TJOoIzbPtLFhHxXCQJRLlUojif0hg"` | The cursor returned by team/groups/list. Indicates from what point to get the next set of groups. |

***

### `Dropbox List Team Groups Members Continue`

Integration name: **DROPBOX\_LIST\_TEAM\_GROUPS\_MEMBERS\_CONTINUE**

Tool to continue listing team group members using a cursor from team/groups/members/list. Use when you have a cursor from a previous group members list call and need to retrieve the next batch of members.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                                                                                                                                                                                                                                 | Description                                                                                                      |
| --------- | ------ | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AAbL--oalATVo-qUR1xnMHfxUpb1FouP_usV_QrQi0fMrb297qjgfNs7CjxnNqty4MUcY6HTt0HkcBxgOkDMxqNLJWbyyvYu9cMGpmUBVlnOeEBNHpQzWej0mRrvSXDS2T-aKOwDIi3BrOzZhS7mVsn_fpoNFedVXFcpUCWnJg1edDUpNCxYSI-qyHLALLBPvFXmkUaz01zOsgktfuiq9_pcRvYwfTxY2RadJNL7JvEd7A5Pf206nInwvqPochiJtI4Xut2dpDzdFA1p-aJ7jOxwDEjvtqbPrIpQWJ6wG-0uJLdKPsPKPZ9Jg5L_5dEbyHs"` | The cursor returned by team/groups/members/list. Indicates from what point to get the next set of group members. |

***

### `Dropbox List Team Linked Apps`

Integration name: **DROPBOX\_LIST\_TEAM\_LINKED\_APPS**

Tool to list all applications linked to team members' accounts. Use when you need to audit or review which third-party applications have been authorized by team members. Supports pagination for large teams.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                   | Description                                                                                                                                                                                         |
| --------- | ------ | :------: | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |          | `"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"` | At the first call, the cursor shouldn't be passed. Then, if the result includes a cursor, subsequent requests should include the received cursor to receive the next sub-list of team applications. |

***

### `Dropbox List Team Member Devices`

Integration name: **DROPBOX\_LIST\_TEAM\_MEMBER\_DEVICES**

Tool to list all device sessions of a team's member, including web sessions, desktop clients, and mobile clients. Use when you need to retrieve information about a team member's active devices and sessions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example                                       | Description                                                                    |
| ------------------------- | ------- | :------: | --------------------------------------------- | ------------------------------------------------------------------------------ |
| `team_member_id`          | string  |     ✅    | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | The team's member id. Can be obtained from team/members/list endpoint.         |
| `include_web_sessions`    | boolean |          | —                                             | Whether to list web sessions of the team's member. Defaults to true.           |
| `include_mobile_clients`  | boolean |          | —                                             | Whether to list linked mobile devices of the team's member. Defaults to true.  |
| `include_desktop_clients` | boolean |          | —                                             | Whether to list linked desktop devices of the team's member. Defaults to true. |

***

### `Dropbox List Team Members`

Integration name: **DROPBOX\_LIST\_TEAM\_MEMBERS**

Tool to list members of a Dropbox team. Use when you need to retrieve information about team members, including their status, roles, and contact details. Supports pagination for teams with many members.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example | Description                                                                                                      |
| ----------------- | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------------------------- |
| `limit`           | integer |          | —       | Number of results to return per call. Maximum is 1000. If not specified, the server will use a default value.    |
| `include_removed` | boolean |          | —       | Whether to return members who have been removed from the team. If true, includes removed members in the results. |

***

### `Dropbox List Team Members Continue`

Integration name: **DROPBOX\_LIST\_TEAM\_MEMBERS\_CONTINUE**

Tool to continue listing team members using a cursor from team/members/list or team/members/list/continue\_v2. Use when you have a cursor from a previous team members list call and need to retrieve the next batch of members.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                            | Description                                                                                                                           |
| --------- | ------ | :------: | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"AAQwkgr3PAthE6u1nueULylh7zNad5wE6YKisbxiFWkk4kcjMqtHTZEnX2jIhV7uUU6_MUpyGcnXe2qIPjED1euB1CmLL3ba_LHK-xTYZizaaA"` | The cursor returned by team/members/list or team/members/list/continue\_v2. Indicates from what point to get the next set of members. |

***

### `Dropbox List Team Namespaces`

Integration name: **DROPBOX\_LIST\_TEAM\_NAMESPACES**

Tool to list all team-accessible namespaces in a Dropbox Business team. Use when you need to discover team folders, shared folders, member home namespaces, or app folders accessible to the team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                   |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Specifying a value here has no effect. The parameter is included for API compatibility but is not functional. |

***

### `Dropbox List Team Namespaces Continue`

Integration name: **DROPBOX\_LIST\_TEAM\_NAMESPACES\_CONTINUE**

Tool to continue paginating through team-accessible namespaces using a cursor from team/namespaces/list. Use when you have a cursor and need to retrieve the next batch of team namespaces.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                    | Description                                                                                                                                               |
| --------- | ------ | :------: | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"your_cursor_token_here"` | Cursor returned by a previous call to team/namespaces/list or team/namespaces/list/continue. Use this to paginate through all team-accessible namespaces. |

***

### `Dropbox List Team Sharing Allowlist Continue`

Integration name: **DROPBOX\_LIST\_TEAM\_SHARING\_ALLOWLIST\_CONTINUE**

Tool to continue paginating through team sharing allowlist entries using a cursor. Use when you have a cursor from a previous sharing\_allowlist/list or sharing\_allowlist/list/continue call and need to retrieve the next batch of allowed domains and emails.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                    | Description                                                                                                                                                |
| --------- | ------ | :------: | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cursor`  | string |     ✅    | `"your_cursor_token_here"` | The cursor returned by a previous call to sharing\_allowlist/list or sharing\_allowlist/list/continue. Use this to paginate through all allowlist entries. |

***

### `Dropbox List Templates For Team`

Integration name: **DROPBOX\_LIST\_TEMPLATES\_FOR\_TEAM**

Tool to list all property templates for a team. Use when you need to retrieve available custom file property templates at the team level. Requires a Dropbox Business account with team-level authentication.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox List User Templates`

Integration name: **DROPBOX\_LIST\_USER\_TEMPLATES**

Tool to get the template identifiers for a user. Use when you need to retrieve available custom file property templates that can be applied to files.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Dropbox Modify Shared Link Settings`

Integration name: **DROPBOX\_MODIFY\_SHARED\_LINK\_SETTINGS**

Tool to modify settings of an existing Dropbox shared link. Use when the user needs to change visibility, access permissions, expiration, or password settings for a shared link. Supports changing audience (public/team/private), access level (viewer/editor), expiration dates, and password protection.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                                                              | Description                                                                                                                   |
| ------------------- | ------- | :------: | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `url`               | string  |     ✅    | `"https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0"` | The URL of the shared link to modify. This must be a valid Dropbox shared link URL.                                           |
| `settings`          | object  |     ✅    | —                                                                    | The new settings to apply to the shared link. Only the specified fields will be updated; unspecified fields remain unchanged. |
| `remove_expiration` | boolean |          | —                                                                    | If set to true, removes the expiration date from the shared link. This overrides any 'expires' value in settings.             |

***

### `Dropbox Mount Folder`

Integration name: **DROPBOX\_MOUNT\_FOLDER**

Tool to mount a shared folder for the current user after they have been added as a member. Once mounted, the shared folder will appear in their Dropbox. Use when a user needs to access a shared folder that has been shared with them but not yet mounted.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example         | Description                           |
| ------------------ | ------ | :------: | --------------- | ------------------------------------- |
| `shared_folder_id` | string |     ✅    | `"13512984419"` | The ID of the shared folder to mount. |

***

### `Dropbox Move Batch`

Integration name: **DROPBOX\_MOVE\_BATCH**

Tool to move multiple files or folders to different locations at once in Dropbox. Use when you need to relocate several items in a single operation. Note that case-only renaming is not supported. The operation may complete synchronously (returning status for each entry) or asynchronously (returning a job ID to check later with move\_batch/check:2).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                  | Type    | Required | Example                                                                                     | Description                                                                                                                           |
| -------------------------- | ------- | :------: | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `entries`                  | array   |     ✅    | `[{"to_path":"/Archive/prime_numbers.txt","from_path":"/Homework/math/prime_numbers.txt"}]` | List of entries to be moved. Each entry specifies a from\_path and to\_path. Minimum 1 entry, maximum 1000 entries.                   |
| `autorename`               | boolean |          | —                                                                                           | If there's a conflict with any file, have the Dropbox server try to autorename that file to avoid the conflict. The default is false. |
| `allow_ownership_transfer` | boolean |          | —                                                                                           | Allow moves by owner even if it would result in an ownership transfer for the content being moved. The default is false.              |

***

### `Dropbox Move File Or Folder`

Integration name: **DROPBOX\_MOVE\_FILE\_OR\_FOLDER**

Move file or folder

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                  | Type    | Required | Example                                      | Description                                                                                                                                                                                                                                                                                         |
| -------------------------- | ------- | :------: | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `to_path`                  | string  |     ✅    | `"/Homework/archive/math_prime_numbers.txt"` | Path in the user's Dropbox that is the destination. This path is case-sensitive.                                                                                                                                                                                                                    |
| `from_path`                | string  |     ✅    | `"/Homework/math/prime_numbers.txt"`         | Path in the user's Dropbox to be moved. This path is case-sensitive. Use canonical paths from metadata (path\_display or path\_lower) rather than manually constructed strings to avoid path/not\_found errors.                                                                                     |
| `autorename`               | boolean |          | —                                            | If there's a conflict (e.g., a file with the same name already exists at the destination), have the Dropbox server try to auto-rename the file to avoid the conflict. The default is false. Leaving this false will cause the call to fail outright when a name conflict exists at the destination. |
| `allow_shared_folder`      | boolean |          | —                                            | If true, allows moving shared folders. The default is false.                                                                                                                                                                                                                                        |
| `allow_ownership_transfer` | boolean |          | —                                            | Allow moves by owner even if it would result in an ownership transfer for the content being moved. This does not apply to copies. The default is false.                                                                                                                                             |

***

### `Dropbox Overwrite File Properties`

Integration name: **DROPBOX\_OVERWRITE\_FILE\_PROPERTIES**

Tool to overwrite property groups associated with a file or folder. Use when you need to force apply or replace custom property values for specific templates on a file.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                              |
| ------------------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `path`                    | string |     ✅    | `"/test_file.txt"`                            | A unique identifier for the file or folder. Can be a path (e.g., '/test\_file.txt') or a file ID.                        |
| `property_groups`         | array  |     ✅    | —                                             | The property groups to force apply. This operation will overwrite existing property groups for the specified templates.  |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on. |

***

### `Dropbox Read File`

Integration name: **DROPBOX\_READ\_FILE**

Downloads a file from the specified Dropbox path, requiring `files.content.read` scope. Response field `file_content_bytes` is base64-encoded binary; decode before saving or passing to libraries. Bursty reads may trigger HTTP 429; honor the `Retry-After` header.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example        | Description                                                                                                                                                                                                                                                     |
| --------- | ------ | :------: | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`    | string |     ✅    | `"/photo.jpg"` | The path to search in Must be a canonical Dropbox path from `path_display` or `path_lower` in API results — hand-typed paths frequently cause not-found or 409 errors. Paths in shared/team folders may become invalid if items are moved or access is revoked. |

***

### `Dropbox Remove File Member`

Integration name: **DROPBOX\_REMOVE\_FILE\_MEMBER**

Tool to remove a specified member from a file's sharing permissions. Use when you need to revoke a member's access to a shared file. Note: This does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                       | Description                                                                                 |
| --------- | ------ | :------: | ----------------------------- | ------------------------------------------------------------------------------------------- |
| `file`    | string |     ✅    | `"id:7bh4zBmgZoAAAAAAAAAAFg"` | File from which to remove members. Use the file ID in the format 'id:...' or the file path. |
| `member`  | object |     ✅    | —                             | Member to remove from this file. Specify either by email or dropbox\_id.                    |

***

### `Dropbox Remove File Properties`

Integration name: **DROPBOX\_REMOVE\_FILE\_PROPERTIES**

Tool to permanently remove specified property groups from a file or folder. Use when you need to delete custom properties associated with a file.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                                                                                                                    |
| ------------------------- | ------ | :------: | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`                    | string |     ✅    | `"/test_properties_file.txt"`                 | A unique identifier for the file or folder. This can be a path (e.g., '/test\_properties\_file.txt') or a file ID.                                                                                             |
| `property_template_ids`   | array  |     ✅    | `["ptid:1a5n2i6d3OYEAAAAAAAAAYa"]`            | A list of identifiers for property templates to remove from the file. These are template IDs created by templates/add\_for\_user or templates/add\_for\_team. Use an empty list to remove all property groups. |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on.                                                                                       |

***

### `Dropbox Remove File Properties Template For Team`

Integration name: **DROPBOX\_REMOVE\_FILE\_PROPERTIES\_TEMPLATE\_FOR\_TEAM**

Tool to remove a property template from a team. Use when you need to delete a file properties template that was previously added to the team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                         | Description                                                                                                     |
| ------------- | ------ | :------: | ------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `template_id` | string |     ✅    | `"ptid:4YzeuMHpwCgAAAAAAAAAPQ"` | An identifier for a template created by templates/add\_for\_user or templates/add\_for\_team. Format: ptid:XXXX |

***

### `Dropbox Remove File Tag`

Integration name: **DROPBOX\_REMOVE\_FILE\_TAG**

Tool to remove a tag from a file or folder in Dropbox. Use when you need to delete or untag an existing tag from an item. The tag will be removed only if it exists on the specified path.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                              |
| ------------------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `path`                    | string |     ✅    | `"/test.txt"`                                 | Path to the file or folder to remove the tag from. Must start with a slash.                                              |
| `tag_text`                | string |     ✅    | `"important"`                                 | The tag to remove. Will be automatically converted to lowercase letters by Dropbox.                                      |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on. |

***

### `Dropbox Remove Folder Member`

Integration name: **DROPBOX\_REMOVE\_FOLDER\_MEMBER**

Tool to remove a member from a shared folder. Use when an owner or editor needs to revoke access for a user or group. The member can be identified by email or Dropbox ID. On success, the response is empty; on error, contains detailed error information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example         | Description                                                                                                                                                                         |
| ------------------ | ------- | :------: | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `member`           | object  |     ✅    | —               | The member to remove from the shared folder. Can be identified by email address or Dropbox ID                                                                                       |
| `leave_a_copy`     | boolean |          | —               | If true, the removed user will keep their copy of the folder after it's unshared (if mounted). Otherwise, it will be removed from their Dropbox. Must be false when kicking a group |
| `shared_folder_id` | string  |     ✅    | `"13497809747"` | The ID for the shared folder from which to remove the member                                                                                                                        |

***

### `Dropbox Remove Group Members`

Integration name: **DROPBOX\_REMOVE\_GROUP\_MEMBERS**

Tool to remove members from a Dropbox team group. Use when you need to remove one or more users from a team group. Requires team admin permissions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example | Description                                                                                                                                              |
| ---------------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group`          | object  |     ✅    | —       | The group from which users will be removed. Specify either by group\_id or group\_external\_id                                                           |
| `users`          | array   |     ✅    | —       | List of users to be removed from the group. Each user can be identified by team\_member\_id, external\_id, or email                                      |
| `return_members` | boolean |          | —       | Whether to return the list of members in the group after removal. Note that setting this to true may take a long time for large groups. Default is false |

***

### `Dropbox Remove Sharing Allowlist`

Integration name: **DROPBOX\_REMOVE\_SHARING\_ALLOWLIST**

Tool to remove domains or email addresses from the team sharing allowlist. Use when team admins need to revoke approval for specific domains or emails. Requires team admin authentication. At least one of 'domains' or 'emails' must be provided, with a maximum of 1000 entries per call. Entries must already exist on the allowlist.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example              | Description                                                                                                                                                                                                                                                                                             |
| --------- | ----- | :------: | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `emails`  | array |          | `"user@example.com"` | List of email addresses to remove from the allowlist. Each email must be a valid string representation following RFC-5322/822 (e.g., '<user@example.com>'). Entries must already exist on the allowlist. Maximum 1000 entries per call. At least one of 'domains' or 'emails' must be provided          |
| `domains` | array |          | `"example.com"`      | List of domains to remove from the allowlist. Each domain must be a valid string representation following RFC-1034/5 (e.g., 'example.com', 'subdomain.example.org'). Entries must already exist on the allowlist. Maximum 1000 entries per call. At least one of 'domains' or 'emails' must be provided |

***

### `Dropbox Remove Team Member Custom Quota`

Integration name: **DROPBOX\_REMOVE\_TEAM\_MEMBER\_CUSTOM\_QUOTA**

Tool to remove custom storage quota for team members, reverting them to the team's default quota. Use when you need to reset storage limits for specific team members. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                                                                                                                            |
| --------- | ----- | :------: | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `users`   | array |     ✅    | —       | List of users to remove custom quota from. Each user must be identified by exactly one of: team\_member\_id, external\_id, or email. Maximum of 1000 users per request |

***

### `Dropbox Remove Team Member Space Limits Excluded Users`

Integration name: **DROPBOX\_REMOVE\_TEAM\_MEMBER\_SPACE\_LIMITS\_EXCLUDED\_USERS**

Tool to remove users from the member space limits excluded users list. Use when you need to re-enable space limits for specific team members. Maximum of 1000 users per request. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                                                 |
| --------- | ----- | :------: | ------- | ------------------------------------------------------------------------------------------- |
| `users`   | array |     ✅    | —       | List of users to be removed from the excluded users list. Maximum of 1000 users per request |

***

### `Dropbox Rename Team Folder`

Integration name: **DROPBOX\_RENAME\_TEAM\_FOLDER**

Tool to rename an existing team folder in Dropbox. Use when you need to update the name of a team folder.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                   | Description                                                                          |
| ---------------- | ------ | :------: | ------------------------- | ------------------------------------------------------------------------------------ |
| `name`           | string |     ✅    | `"Marketing Team Folder"` | New name for the team folder.                                                        |
| `team_folder_id` | string |     ✅    | `"13752586147"`           | The ID of the team folder to rename. You can get this from list team folders action. |

***

### `Dropbox Resend Secondary Email Verification`

Integration name: **DROPBOX\_RESEND\_SECONDARY\_EMAIL\_VERIFICATION**

Tool to resend secondary email verification emails to team members. Use when team members need verification emails resent for their secondary email addresses. Requires team admin credentials.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type  | Required | Example | Description                                                                                                                                                |
| ------------------ | ----- | :------: | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `emails_to_resend` | array |     ✅    | —       | Collection of users paired with secondary emails needing verification resent. Each item contains the user identifier and list of secondary email addresses |

***

### `Dropbox Restore File`

Integration name: **DROPBOX\_RESTORE\_FILE**

Tool to restore a specific revision of a file to the given path in Dropbox. Use when you need to revert a file to a previous version using its revision identifier.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                             | Description                                                                                           |
| --------- | ------ | :------: | ----------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `rev`     | string |     ✅    | `"01649efbe6f88ab00000002e00499b3"` | The revision to restore for the file. This is a unique identifier for a specific version of the file. |
| `path`    | string |     ✅    | `"/test_restore_file.txt"`          | The path to the file you want to restore in the user's Dropbox. Path is case-sensitive.               |

***

### `Dropbox Revoke Shared Link`

Integration name: **DROPBOX\_REVOKE\_SHARED\_LINK**

Tool to revoke a Dropbox shared link. Use when you need to remove access to a file or folder by disabling its shared link. Note that revoking a direct link to a file may not fully prevent access if parent folders have active shared links.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                | Description                                                                                                                                                                                |
| --------- | ------ | :------: | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `url`     | string |     ✅    | `"https://www.dropbox.com/scl/fi/5qnoiq0sb4bra3mwwpsfs/test.txt?rlkey=v2ld1w6kc7wimjf55uqjloz3t&dl=0"` | The URL of the shared link to revoke. Can be any valid Dropbox shared link URL. Note: After revoking a link, the file may still be accessible if there are shared links to parent folders. |

***

### `Dropbox Save Copy Reference`

Integration name: **DROPBOX\_SAVE\_COPY\_REFERENCE**

Tool to save a copy reference to the user's Dropbox. Use when you have a copy reference (obtained from copy\_reference/get) and need to save it to a specific destination path.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                         | Description                                                                                                                                                |
| ---------------- | ------ | :------: | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`           | string |     ✅    | `"/test_file_copy_saved.txt"`   | Path in the user's Dropbox that is the destination where the referenced file or folder will be saved. This path is case-sensitive and must start with '/'. |
| `copy_reference` | string |     ✅    | `"AAAAAuAEmbNibzBibzd2dnR5dG0"` | A copy reference returned by copy\_reference/get. This is an opaque string that can be used to save a file or folder to the user's Dropbox.                |

***

### `Dropbox Save Url`

Integration name: **DROPBOX\_SAVE\_URL**

Tool to save a file to Dropbox directly from a public URL via server-side fetch. Use when you have a temporary or public link and want Dropbox to download it directly without local staging. The operation is asynchronous and may take up to 15 minutes for large files.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type    | Required | Example                                       | Description                                                                                                              |
| ------------------------- | ------- | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `url`                     | string  |     ✅    | `"https://example.com/file.pdf"`              | The URL to be saved. Must be a valid, publicly accessible URL.                                                           |
| `path`                    | string  |     ✅    | `"/images/downloaded.png"`                    | The path in Dropbox where the URL will be saved to (including filename). Must start with a slash.                        |
| `wait`                    | boolean |          | —                                             | If true, poll the job status until completion or timeout. If false, return the async\_job\_id immediately.               |
| `timeout_seconds`         | integer |          | —                                             | Maximum time in seconds to wait for job completion when wait=true. Ignored if wait=false.                                |
| `Dropbox-API-Select-User` | string  |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on. |

***

### `Dropbox Search Continue`

Integration name: **DROPBOX\_SEARCH\_CONTINUE**

Tool to fetch the next page of search results from a previous Dropbox search. Use when you have a cursor from a search operation and need to retrieve additional results. Note: search along with search\_continue can only retrieve a maximum of 10,000 matches total.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                   | Description                                                                                                  |
| --------- | ------ | :------: | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `cursor`  | string |     ✅    | `"ZtkX9_EHj3x7PMkVuFIhwKYXEpwpLwyxp9vMKomUhllil9q7eWiAu"` | The cursor returned by your last call to search or search\_continue. Used to fetch the next page of results. |

***

### `Dropbox Search File Or Folder`

Integration name: **DROPBOX\_SEARCH\_FILE\_OR\_FOLDER**

Tool to search for files and folders in Dropbox by name or content, optionally scoped to a path, with pagination support. Results paginate via cursor (up to 100 per page); check `has_more` in the response and re-fetch with the cursor until `has_more` is false. Newly indexed items may have a brief delay before appearing. Verify `path_display` and `.tag` (file vs folder) on each result before acting, as multiple similar-named items may match. Results are limited to items visible to the authenticated user.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------- | ------ | :------: | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`                   | string |          | —                                             | The search string. Must be 1 or more non-whitespace characters. Queries are case-insensitive. Required unless cursor is provided.                                                                                                                                                                                                                                                                                                                                       |
| `cursor`                  | string |          | —                                             | Cursor from a previous search response for fetching the next page of results. When provided, all other parameters are ignored and the continue endpoint is called.                                                                                                                                                                                                                                                                                                      |
| `options`                 | object |          | —                                             | Additional options for the search. If not provided, default search options will be used. Key sub-fields: `path` (must start with '/' or use 'id:...' format; omit to search entire account, narrow to reduce noise); `file_categories` and `file_extensions` to filter by type; no native date-range filter — apply date logic client-side using `server_modified` (UTC). Prefer reusing `path_display` values from prior results rather than manually composing paths. |
| `match_field_options`     | object |          | —                                             | Options for match field highlighting. If not provided, default options will be used.                                                                                                                                                                                                                                                                                                                                                                                    |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on.                                                                                                                                                                                                                                                                                                                                                |

***

### `Dropbox Search File Properties`

Integration name: **DROPBOX\_SEARCH\_FILE\_PROPERTIES**

Tool to search across property templates for particular property field values. Use when you need to find files or folders that have specific custom property values (e.g., find all files with priority='high'). Note: This endpoint does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type   | Required | Example | Description                                                                                                               |
| ----------------- | ------ | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------- |
| `queries`         | array  |     ✅    | —       | List of queries to search. Each query specifies a property field value to search for and the field name to search within. |
| `template_filter` | object |          | —       | Filter results to contain only properties associated with specific template IDs.                                          |

***

### `Dropbox Send Team Member Welcome Email`

Integration name: **DROPBOX\_SEND\_TEAM\_MEMBER\_WELCOME\_EMAIL**

Tool to send a welcome email to a pending team member. Use when a team admin needs to resend or send a welcome email to a user who has been invited to the team.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type   | Required | Example                                       | Description                                                                                                                    |
| ---------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `.tag`           | string |     ✅    | —                                             | Type of identifier to use: 'team\_member\_id' for team member ID, 'external\_id' for external ID, or 'email' for email address |
| `email`          | string |          | `"partnerships@usefulagents.com"`             | Email address of the user. Required when tag is 'email'                                                                        |
| `external_id`    | string |          | —                                             | External ID of the user. Required when tag is 'external\_id'                                                                   |
| `team_member_id` | string |          | `"dbmid:AAFdgehTzw7WlXhZJsbGCLePe8RvQGYDr-I"` | The team member ID of the user. Required when tag is 'team\_member\_id'                                                        |

***

### `Dropbox Set Profile Photo`

Integration name: **DROPBOX\_SET\_PROFILE\_PHOTO**

Tool to set the profile photo for the current user's Dropbox account. Use when you need to update or change the user's profile picture. Requires a base64-encoded JPEG image.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                              |
| ------------------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `photo`                   | object |     ✅    | —                                             | Photo data to set as the profile photo. Must be a base64-encoded JPEG image.                                             |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on. |

***

### `Dropbox Set Team Member Custom Quota`

Integration name: **DROPBOX\_SET\_TEAM\_MEMBER\_CUSTOM\_QUOTA**

Tool to set custom storage quotas for team members in Dropbox. Use when you need to assign specific storage limits to individual team members. Maximum of 1000 users per request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type  | Required | Example | Description                                                                      |
| ------------------ | ----- | :------: | ------- | -------------------------------------------------------------------------------- |
| `users_and_quotas` | array |     ✅    | —       | List of users and their custom quotas to set. Maximum of 1000 users per request. |

***

### `Dropbox Share Folder`

Integration name: **DROPBOX\_SHARE\_FOLDER**

Tool to share a folder with collaborators in Dropbox. Most sharing will be completed synchronously, but large folders will be completed asynchronously. If an async\_job\_id is returned, you'll need to call check\_share\_job\_status until the action completes to get the folder metadata. Use when you need to create a shared folder or convert an existing folder to a shared folder.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example               | Description                                                                                                                                                                                                     |
| -------------------- | ------- | :------: | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`               | string  |     ✅    | `"/TestSharedFolder"` | The path to the folder to share. If it does not exist, then a new one is created. Must be a valid Dropbox path (e.g., '/TestSharedFolder').                                                                     |
| `actions`            | array   |          | —                     | A list of FolderActions corresponding to FolderPermissions that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder. |
| `force_async`        | boolean |          | —                     | Whether to force the share to happen asynchronously. Large folders will be completed asynchronously anyway. Set to true to make testing the async case repeatable.                                              |
| `link_settings`      | object  |          | —                     | Settings that apply to a link.                                                                                                                                                                                  |
| `member_policy`      | object  |          | —                     | Policy governing who can be a member of a shared folder.                                                                                                                                                        |
| `acl_update_policy`  | object  |          | —                     | Who can change a shared folder's access control list.                                                                                                                                                           |
| `shared_link_policy` | object  |          | —                     | Who can view shared links in this folder.                                                                                                                                                                       |
| `viewer_info_policy` | object  |          | —                     | Who can enable/disable viewer info for this shared folder.                                                                                                                                                      |

***

### `Dropbox Start Upload Session`

Integration name: **DROPBOX\_START\_UPLOAD\_SESSION**

Tool to start a new upload session with the given data. Use when uploading large files in multiple requests. This call starts the session and you can then use upload\_session/append\_v2 to add more data and upload\_session/finish to complete the upload. A single request should not upload more than 150 MiB.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                                                                                                 |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `close`   | boolean |          | —       | If true, the current session will be closed after uploading this data, at which point you won't be able to call upload\_session/append\_v2 anymore with the current session. Set to false to keep the session open for appending more data. |
| `content` | object  |     ✅    | —       | File data to upload in this initial session.                                                                                                                                                                                                |

***

### `Dropbox Start Upload Session Batch`

Integration name: **DROPBOX\_START\_UPLOAD\_SESSION\_BATCH**

Tool to start a batch of upload sessions. Use when you need to upload multiple large files and want to initialize multiple upload sessions at once. Each session can then be used with upload\_session/append\_v2 to upload file chunks and upload\_session/finish\_batch to complete the uploads.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type    | Required | Example        | Description                                                                                                                                                                                         |
| -------------- | ------- | :------: | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `num_sessions` | integer |     ✅    | `1`            | The number of upload sessions to start. Must be between 1 and 1000.                                                                                                                                 |
| `session_type` | string  |          | `"sequential"` | Type of upload session. 'sequential' means pieces of data are uploaded sequentially one after another (default). 'concurrent' means pieces of data can be uploaded in concurrent RPCs in any order. |

***

### `Dropbox Unlock File Batch`

Integration name: **DROPBOX\_UNLOCK\_FILE\_BATCH**

Tool to unlock multiple files at specified paths in a single batch operation. Locked files can only be unlocked by the lock holder or a team admin (for business accounts). Returns metadata for each unlocked file or error details for failures.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type  | Required | Example | Description                                                                                              |
| --------- | ----- | :------: | ------- | -------------------------------------------------------------------------------------------------------- |
| `entries` | array |     ✅    | —       | List of files to unlock. Each entry contains a path or file ID. Duplicate paths are processed only once. |

***

### `Dropbox Unmount Folder`

Integration name: **DROPBOX\_UNMOUNT\_FOLDER**

Tool to unmount a shared folder for the current user. Once unmounted, the shared folder will be removed from the user's Dropbox. Use when a user wants to remove a shared folder from their Dropbox while remaining a member of the folder.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example         | Description                             |
| ------------------ | ------ | :------: | --------------- | --------------------------------------- |
| `shared_folder_id` | string |     ✅    | `"13495912993"` | The ID of the shared folder to unmount. |

***

### `Dropbox Unshare File`

Integration name: **DROPBOX\_UNSHARE\_FILE**

Tool to remove all members from a Dropbox file. Use when you need to revoke access for all collaborators on a file. Note: This does not remove inherited members from parent folders and does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                       | Description                                                                                                                                                                                                      |
| --------- | ------ | :------: | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `file`    | string |     ✅    | `"id:7bh4zBmgZoAAAAAAAAABJA"` | The file to unshare. Use the file ID format (e.g., 'id:7bh4zBmgZoAAAAAAAAABJA') or a path to the file. This action removes all members from the file, but does not remove inherited members from parent folders. |

***

### `Dropbox Unshare Folder`

Integration name: **DROPBOX\_UNSHARE\_FOLDER**

Tool to allow a shared folder owner to unshare the folder. Use when you need to stop sharing a folder with all members. Unshare will not work if: the shared folder contains shared folders OR the shared folder is inside another shared folder. You must call check\_job\_status with the returned async\_job\_id to determine if the action completed successfully. Requires sharing.write scope.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example         | Description                                                                                                                                                                                                                     |
| ------------------ | ------- | :------: | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `leave_a_copy`     | boolean |          | —               | If true, members of this shared folder will get a copy of this folder after it's unshared. Otherwise, it will be removed from their Dropbox. The current user, who is an owner, will always retain their copy. Default is false |
| `shared_folder_id` | string  |     ✅    | `"13512984419"` | The ID for the shared folder to unshare. You can get this from list\_shared\_folders action                                                                                                                                     |

***

### `Dropbox Update File Member`

Integration name: **DROPBOX\_UPDATE\_FILE\_MEMBER**

Tool to change a member's access level on a shared file. Use when you need to update permissions for an existing file member (e.g., change from editor to viewer or vice versa). Note: This endpoint does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                   | Description                                                                                                                                                                                          |
| -------------- | ------ | :------: | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `file`         | string |     ✅    | `"/Documents/report.pdf"` | File for which to update the member's access. Can be a file path (e.g., '/test\_read\_file\_basic.txt') or file ID (e.g., 'id:xxxxx').                                                               |
| `member`       | object |     ✅    | —                         | The member whose access to update. Identify by email or Dropbox ID.                                                                                                                                  |
| `access_level` | string |     ✅    | —                         | The new access level for the member. 'viewer' - The member can only view the file. 'editor' - The member can edit the file. Note: Editor access may fail with no\_permission for certain file types. |

***

### `Dropbox Update File Properties`

Integration name: **DROPBOX\_UPDATE\_FILE\_PROPERTIES**

Tool to update custom properties on a file or folder in Dropbox. Use when you need to modify metadata fields associated with a property template, such as updating status, priority, or other custom attributes. Requires the files.metadata.write scope.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                       | Description                                                                                                                     |
| ------------------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `path`                    | string |     ✅    | `"/Documents/report.pdf"`                     | A unique identifier for the file or folder. Can be a path (e.g., '/test.txt') or file ID (e.g., 'id:a4ayc\_80\_OEAAAAAAAAAXz'). |
| `update_property_groups`  | array  |     ✅    | —                                             | The property groups 'delta' updates to apply. Each update specifies a template ID and the fields to add/update or remove.       |
| `Dropbox-API-Select-User` | string |          | `"dbmid:AACzIks68_T0zljJAk8hGSmt0rLx6g5X9p0"` | Team member ID (format: dbmid:...) required when using team tokens. Specifies which team member's account to operate on.        |

***

### `Dropbox Update File Request`

Integration name: **DROPBOX\_UPDATE\_FILE\_REQUEST**

Tool to update an existing file request in Dropbox. Use when you need to modify the title, destination, deadline, open/closed status, or description of a file request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example | Description                                                                                                                        |
| ------------- | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | string  |     ✅    | —       | The ID of the file request to update. Example: 'oaCAVmEyrqYnkZX9955Y'                                                              |
| `open`        | boolean |          | —       | Whether to set this file request as open or closed. If true, the file request will accept files. If false, it will be closed.      |
| `title`       | string  |          | —       | The new title of the file request. Must not be empty if provided.                                                                  |
| `deadline`    | object  |          | —       | Represents the deadline parameters when updating a file request deadline.                                                          |
| `description` | string  |          | —       | The new description of the file request.                                                                                           |
| `destination` | string  |          | —       | The new path in the user's Dropbox where uploaded files will be saved. Must be a path starting with '/'. Example: '/Homework/math' |

***

### `Dropbox Update Folder Member`

Integration name: **DROPBOX\_UPDATE\_FOLDER\_MEMBER**

Tool to update another member's permissions in a shared folder. Use when an owner or editor needs to change access levels for existing members. This endpoint does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example         | Description                                                                                                                                                      |
| ------------------ | ------ | :------: | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `member`           | object |     ✅    | —               | The member of the shared folder to update. Note: Only the dropbox\_id may be used for updates according to API docs, but email is also supported by the endpoint |
| `access_level`     | object |     ✅    | —               | The new access level for the member. Note: Cannot set access level to 'owner' through this endpoint                                                              |
| `shared_folder_id` | string |     ✅    | `"84528192421"` | The ID of the shared folder containing the member to update. You can get this from list\_shared\_folders action                                                  |

***

### `Dropbox Update Folder Policy`

Integration name: **DROPBOX\_UPDATE\_FOLDER\_POLICY**

Tool to update the sharing policies for a shared folder. Use when you need to change who can be members, who can update the ACL, viewer info settings, shared link policies, or link settings. User must have AccessLevel.owner access to the shared folder.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example         | Description                                                                                                                                                                                                    |
| -------------------- | ------ | :------: | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `actions`            | array  |          | —               | A list of FolderActions corresponding to FolderPermissions that should appear in the response's SharedFolderMetadata.permissions field describing the actions the authenticated user can perform on the folder |
| `link_settings`      | object |          | —               | Settings that apply to a link.                                                                                                                                                                                 |
| `member_policy`      | object |          | —               | Policy governing who can be a member of a shared folder.                                                                                                                                                       |
| `shared_folder_id`   | string |     ✅    | `"13512984419"` | The ID for the shared folder. You must have AccessLevel.owner access to update its policies                                                                                                                    |
| `acl_update_policy`  | object |          | —               | Who can change a shared folder's access control list (ACL).                                                                                                                                                    |
| `shared_link_policy` | object |          | —               | Policy governing who can view shared links.                                                                                                                                                                    |
| `viewer_info_policy` | object |          | —               | Policy governing who can view viewer information.                                                                                                                                                              |

***

### `Dropbox Update Group Member Access Type`

Integration name: **DROPBOX\_UPDATE\_GROUP\_MEMBER\_ACCESS\_TYPE**

Tool to change a member's access type in a team group. Use when you need to promote a member to owner or demote an owner to regular member. Requires team admin permissions with group management capabilities.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example | Description                                                                                                                                                                             |
| ---------------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`           | object  |     ✅    | —       | The user whose access type will be changed. Must be an existing member of the group. Can be identified by team\_member\_id, external\_id, or email                                      |
| `group`          | object  |     ✅    | —       | The group containing the member whose access type will be changed. Specify either by group\_id or group\_external\_id                                                                   |
| `access_type`    | object  |     ✅    | —       | The new access type to assign to the user in the group                                                                                                                                  |
| `return_members` | boolean |          | —       | Whether to return the list of members in the group after updating. Note that the default value will cause all group members to be returned, which may take a long time for large groups |

***

### `Dropbox Update Paper Document`

Integration name: **DROPBOX\_UPDATE\_PAPER\_DOCUMENT**

Tool to update an existing Dropbox Paper document with new content in Markdown, HTML, or plain text format. Use when you need to modify, append, prepend, or overwrite content in an existing Paper doc. This endpoint does not support apps with the app folder permission.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter           | Type    | Required | Example                                                         | Description                                                                                                                                                                                                      |
| ------------------- | ------- | :------: | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path`              | string  |     ✅    | `"/API Test Document.paper"`                                    | Path to the existing Paper doc in Dropbox to update. MUST include the .paper extension at the end (e.g., '/My Documents/Notes.paper').                                                                           |
| `content`           | string  |     ✅    | `"\n\nThis is additional content appended via the update API."` | Content to add or replace in the Paper document based on the update policy.                                                                                                                                      |
| `import_format`     | string  |     ✅    | `"plain_text"`                                                  | Format of the provided content: plain\_text, markdown, or html.                                                                                                                                                  |
| `paper_revision`    | integer |          | `1`                                                             | The paper revision number. Required when doc\_update\_policy is 'update'. This value must match the current revision of the doc or an error will be returned.                                                    |
| `doc_update_policy` | string  |     ✅    | `"append"`                                                      | Policy for updating the document: 'append' adds content to the end, 'prepend' adds content to the beginning, 'overwrite' replaces all content, 'update' merges content intelligently (requires paper\_revision). |

***

### `Dropbox Update Property Template For Team`

Integration name: **DROPBOX\_UPDATE\_PROPERTY\_TEMPLATE\_FOR\_TEAM**

Tool to update a property template for a team in Dropbox. Use when you need to modify an existing template's name, description, or add new property fields. Requires team admin permissions and a Dropbox Business account.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                                   | Description                                                                                                                        |
| ------------- | ------ | :------: | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `name`        | string |          | `"Updated Test Template"`                 | A display name for the template. Template names can be up to 256 bytes. If not provided, the name will not be changed.             |
| `add_fields`  | array  |          | —                                         | Property field templates to be added to the group template. There can be up to 32 properties in a single template.                 |
| `description` | string |          | `"Updated description for test template"` | Description for the template. Template descriptions can be up to 1024 bytes. If not provided, the description will not be changed. |
| `template_id` | string |     ✅    | `"ptid:4YzeuMHpwCgAAAAAAAAAfQ"`           | An identifier for template added by templates/add\_for\_user or templates/add\_for\_team. Typically in the format 'ptid:XXXXX'.    |

***

### `Dropbox Update Team Folder Sync Settings`

Integration name: **DROPBOX\_UPDATE\_TEAM\_FOLDER\_SYNC\_SETTINGS**

Tool to update the sync settings on a team folder or its contents in Dropbox. Use when you need to control whether a team folder or specific content within it is synchronized to members' devices. This is useful for managing storage space and controlling access to sensitive content.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example        | Description                                                                                                                                   |
| ----------------------- | ------ | :------: | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `sync_setting`          | string |     ✅    | `"not_synced"` | The sync setting to apply to the team folder. Possible values: 'default' (sync normally), 'not\_synced' (do not sync)                         |
| `team_folder_id`        | string |     ✅    | `"123456789"`  | The ID of the team folder to update sync settings for. You can get this from list\_team\_folders or other team folder operations              |
| `content_sync_settings` | array  |          | —              | Optional list of content-specific sync settings within the team folder. Each entry specifies a file or folder ID and its desired sync setting |

***

### `Dropbox Update Team Group`

Integration name: **DROPBOX\_UPDATE\_TEAM\_GROUP**

Tool to update a team group's name, external ID, and/or management type. Use when you need to modify group properties such as renaming a group or changing how it's managed.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                   | Type    | Required | Example                    | Description                                                                                                                                                            |
| --------------------------- | ------- | :------: | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group`                     | object  |     ✅    | —                          | Specify the group to update by either group\_id or group\_external\_id.                                                                                                |
| `new_group_name`            | string  |          | `"Updated Marketing Team"` | The new name for the group. If not provided, the group name remains unchanged.                                                                                         |
| `return_members`            | boolean |          | —                          | Whether to return the list of members in the response. Note that the default will cause all group members to be returned, which may take a long time for large groups. |
| `new_group_external_id`     | string  |          | —                          | The new external ID for the group. If not provided, the external ID remains unchanged. Set to empty string to clear the external ID.                                   |
| `new_group_management_type` | object  |          | —                          | The management type for the group.                                                                                                                                     |

***

### `Dropbox Update Team Member Admin Permissions`

Integration name: **DROPBOX\_UPDATE\_TEAM\_MEMBER\_ADMIN\_PERMISSIONS**

Tool to update a team member's admin permissions. Use when you need to grant or revoke admin privileges for team members. Requires team admin permissions to execute.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example | Description                                                                                                                                       |
| ---------- | ------ | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`     | object |     ✅    | —       | Identity of the team member whose admin permissions will be set. Use exactly one of team\_member\_id, email, or external\_id to identify the user |
| `new_role` | object |     ✅    | —       | The new admin permissions role to assign to the team member                                                                                       |

***

### `Dropbox Update Team Member Profile`

Integration name: **DROPBOX\_UPDATE\_TEAM\_MEMBER\_PROFILE**

Tool to update a team member's profile information. Use when you need to change a team member's email, name, external ID, or directory restrictions. At least one profile field must be provided for update.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                     | Type    | Required | Example | Description                                                                                                                                       |
| ----------------------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user`                        | object  |     ✅    | —       | Identity of user whose profile will be set. Exactly one of team\_member\_id, email, or external\_id must be provided to identify the user account |
| `new_email`                   | string  |          | —       | New email for member                                                                                                                              |
| `new_surname`                 | string  |          | —       | New surname for member                                                                                                                            |
| `new_given_name`              | string  |          | —       | New given name for member                                                                                                                         |
| `new_external_id`             | string  |          | —       | New external ID for member                                                                                                                        |
| `new_persistent_id`           | string  |          | —       | New persistent ID. This field only available to teams using persistent ID SAML configuration                                                      |
| `new_is_directory_restricted` | boolean |          | —       | New value for whether the user is a directory restricted user                                                                                     |

***

### `Dropbox Update Team Member Profile Photo`

Integration name: **DROPBOX\_UPDATE\_TEAM\_MEMBER\_PROFILE\_PHOTO**

Tool to update a team member's profile photo. Use when you need to set or change the profile picture of a team member. Requires team admin permissions and a JPEG image (minimum 128x128 pixels) in base64 format.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                                  |
| --------- | ------ | :------: | ------- | ------------------------------------------------------------ |
| `user`    | object |     ✅    | —       | The team member whose profile photo should be updated.       |
| `photo`   | object |     ✅    | —       | The photo data to be set as the team member's profile photo. |

***

### `Dropbox Upload File`

Integration name: **DROPBOX\_UPLOAD\_FILE**

Uploads a file (up to \~150 MB) to a specified path in the user's Dropbox, with options for handling existing files. Files larger than 150 MB require a chunked upload approach.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter         | Type    | Required | Example               | Description                                                                                                                                                                                                                                                                                                                             |
| ----------------- | ------- | :------: | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `mode`            | string  |          | `"add"`               | Specifies how to handle the upload if a file already exists at the specified path.                                                                                                                                                                                                                                                      |
| `mute`            | boolean |          | —                     | If true, the user will not be notified of the new file via desktop or mobile notifications.                                                                                                                                                                                                                                             |
| `path`            | string  |     ✅    | `"/Images/photo.jpg"` | Path in the user's Dropbox to save the file.                                                                                                                                                                                                                                                                                            |
| `content`         | object  |     ✅    | —                     | File to be uploaded; supports various formats including images, PDFs, and text files. Must be a valid internal s3key obtained from a trusted upload helper — raw file bytes, public URLs, or manually constructed keys are not accepted. Ensure the content is the intended file and not an HTML/XML error page from the source server. |
| `autorename`      | boolean |          | —                     | If true and a file already exists at the path, the new file will be renamed to avoid conflict.                                                                                                                                                                                                                                          |
| `strict_conflict` | boolean |          | —                     | If true, the upload will be rejected if the file already exists, regardless of the autorename setting.                                                                                                                                                                                                                                  |

***


---

# 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.toolhouse.ai/toolhouse/integrations/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.
