> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Dropbox
> What agents can do in Dropbox at each access level, and how to connect, limit, and disconnect Dropbox.
Connect Dropbox so your agents can work in your Dropbox account. You choose an access level for each account, and Squad refuses any agent action outside that level.
## Access levels
Each Dropbox account has an access level: **Read-only**, **Read + write**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
| Level | The connect window describes this level as | Actions agents can use |
| ------------------------------ | ----------------------------------------------------------- | ---------------------- |
| **Read-only** | "Read account info, file list, and content." | 94 of 178 |
| **Read + write** (recommended) | "Read and upload/edit/delete files." | 162 of 178 |
| **Full access** | "Also create share links, file requests, access team data." | 178 of 178 |
**Read + write** is the recommended level. The connect window selects it for you, and you can choose another level.
The Dropbox sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in. It checks every agent action against the level you chose, and it refuses actions outside that level.
## What agents can do at each level
Each level opens with a short summary in plain tasks, then lists every action it adds, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.
**Find an action.** Open a level and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Dropbox account?" The agent can search the Dropbox actions for you.
Each action shows its name, a one-line description where the Dropbox action catalog has one, and its slug. The slug is the ID that agents use when they call the action.
Agents can use 94 of the 178 Dropbox actions at this level:
* View and search files
* View folders
* View members
* View jobs
* View templates
* View account details
* View apps
* View groups
* View shared links
* View thumbnails
* View usage
* View users
All 94 actions at this level:
| Action | What it does | Slug |
| ----------------- | ---------------------------------------------------------------------- | --------------------------- |
| Get account | Get information about a user's Dropbox account using their account ID. | `DROPBOX_GET_ACCOUNT` |
| Get account batch | Get information about multiple user accounts in a single request. | `DROPBOX_GET_ACCOUNT_BATCH` |
| Action | What it does | Slug |
| ----------------------- | ----------------------------------------------------------------- | --------------------------------- |
| List member linked apps | List all applications linked to a specific team member's account. | `DROPBOX_LIST_MEMBER_LINKED_APPS` |
| List team linked apps | List all applications linked to team members' accounts. | `DROPBOX_LIST_TEAM_LINKED_APPS` |
| Action | What it does | Slug |
| ------------------------ | -------------------------------------------------------------------------------- | ---------------------------------- |
| List paper docs | Return the list of all Paper docs according to filter and sort specifications. | `DROPBOX_LIST_PAPER_DOCS` |
| List paper docs continue | Continue paginating through Paper documents using a cursor from paper/docs/list. | `DROPBOX_LIST_PAPER_DOCS_CONTINUE` |
| Action | What it does | Slug |
| ---------------------------- | --------------------------------------------------------------------------------- | -------------------------------------- |
| Get team log events | Retrieve team audit log events from Dropbox. | `DROPBOX_GET_TEAM_LOG_EVENTS` |
| Get team log events continue | Paginate through team audit log events using a cursor from team\_log/get\_events. | `DROPBOX_GET_TEAM_LOG_EVENTS_CONTINUE` |
| Action | What it does | Slug |
| ----------------------- | ------------------------------------------------------------------------ | --------------------------------- |
| Get team feature values | Get values for one or more team features. | `DROPBOX_GET_TEAM_FEATURE_VALUES` |
| Get user features | Get a list of feature values configured for the current Dropbox account. | `DROPBOX_GET_USER_FEATURES` |
| Action | What it does | Slug |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| Check upload batch | Check the status of an asynchronous upload batch job in Dropbox. | `DROPBOX_CHECK_UPLOAD_BATCH` |
| Count file requests | Get the total number of file requests owned by the authenticated user. | `DROPBOX_COUNT_FILE_REQUESTS` |
| Export file | Export non-downloadable Dropbox files (especially Dropbox Paper) to Markdown/HTML/plain text and return usable content. | `DROPBOX_EXPORT_FILE` |
| Files search | Search for files and folders in Dropbox by name or content. | `DROPBOX_FILES_SEARCH` |
| Get file lock batch | Return lock metadata for multiple files in a single batch request. | `DROPBOX_GET_FILE_LOCK_BATCH` |
| Get file metadata batch | Retrieve metadata for multiple shared files in a single batch request. | `DROPBOX_GET_FILE_METADATA_BATCH` |
| Get file preview | Get a preview for a file. | `DROPBOX_GET_FILE_PREVIEW` |
| Get file request | Retrieve details of an existing file request by ID. | `DROPBOX_GET_FILE_REQUEST` |
| Get shared file metadata | Retrieve metadata for a shared file in Dropbox. | `DROPBOX_GET_SHARED_FILE_METADATA` |
| Get shared link file | Download a file from a Dropbox shared link. | `DROPBOX_GET_SHARED_LINK_FILE` |
| List file requests | List all file requests owned by the current user. | `DROPBOX_LIST_FILE_REQUESTS` |
| List file requests continue | Paginate through file requests using a cursor from a previous list call. | `DROPBOX_LIST_FILE_REQUESTS_CONTINUE` |
| List files in folder | List files and folders in a specified Dropbox directory. | `DROPBOX_LIST_FILES_IN_FOLDER` |
| List received files | List all files shared with the current user. | `DROPBOX_LIST_RECEIVED_FILES` |
| Read file | Downloads a file from the specified Dropbox path, requiring files.content.read scope. | `DROPBOX_READ_FILE` |
| Search file or folder | Search for files and folders in Dropbox by name or content, optionally scoped to a path, with pagination support. | `DROPBOX_SEARCH_FILE_OR_FOLDER` |
| Action | What it does | Slug |
| ------------------------------- | ------------------------------------------------------------------------------------- | ----------------------------------------- |
| Check folder batch | Check the status of an asynchronous folder batch creation job. | `DROPBOX_CHECK_FOLDER_BATCH` |
| Check team folder archive | Check the status of an asynchronous team folder archive job in Dropbox. | `DROPBOX_CHECK_TEAM_FOLDER_ARCHIVE` |
| Get folder cursor | Get a cursor representing the current state of a folder without listing its contents. | `DROPBOX_GET_FOLDER_CURSOR` |
| Get shared folder metadata | Retrieve metadata for a specific shared folder by its ID. | `DROPBOX_GET_SHARED_FOLDER_METADATA` |
| Get team folder info | Retrieve metadata for team folders. | `DROPBOX_GET_TEAM_FOLDER_INFO` |
| List folder continue | Continue paginating through folder contents using a cursor from list\_folder. | `DROPBOX_LIST_FOLDER_CONTINUE` |
| List folders | DEPRECATED: Use ListFilesInFolder instead. | `DROPBOX_LIST_FOLDERS` |
| List folders continue | Continue paginating through shared folders using a cursor from list\_folders. | `DROPBOX_LIST_FOLDERS_CONTINUE` |
| List mountable folders | List all shared folders the current user can mount or unmount. | `DROPBOX_LIST_MOUNTABLE_FOLDERS` |
| List mountable folders continue | Paginate through mountable shared folders using a cursor. | `DROPBOX_LIST_MOUNTABLE_FOLDERS_CONTINUE` |
| List shared folders | List all shared folders the authenticated user has access to. | `DROPBOX_LIST_SHARED_FOLDERS` |
| List team folders | List all team folders for a Dropbox Business team. | `DROPBOX_LIST_TEAM_FOLDERS` |
| List team folders continue | Continue paginating through team folders using a cursor from team\_folder/list. | `DROPBOX_LIST_TEAM_FOLDERS_CONTINUE` |
| Action | What it does | Slug |
| ------------------------- | -------------------------------------------------------------------------------- | ----------------------------------- |
| Get team groups info | Retrieve information about one or more team groups by their IDs or external IDs. | `DROPBOX_GET_TEAM_GROUPS_INFO` |
| List team groups | List all groups on a Dropbox team. | `DROPBOX_LIST_TEAM_GROUPS` |
| List team groups continue | Continue listing team groups using a cursor from team/groups/list. | `DROPBOX_LIST_TEAM_GROUPS_CONTINUE` |
| Action | What it does | Slug |
| ----------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------- |
| Check job status | Check the status of an asynchronous sharing job in Dropbox. | `DROPBOX_CHECK_JOB_STATUS` |
| Check move former member files job status | Check the status of an asynchronous move former member files job. | `DROPBOX_CHECK_MOVE_FORMER_MEMBER_FILES_JOB_STATUS` |
| Check share job status | Check the status of an asynchronous folder sharing job in Dropbox. | `DROPBOX_CHECK_SHARE_JOB_STATUS` |
| Get team groups job status | Check the status of an asynchronous team groups job in Dropbox. | `DROPBOX_GET_TEAM_GROUPS_JOB_STATUS` |
| Get team members add job status | Poll the status of an asynchronous team member addition job. | `DROPBOX_GET_TEAM_MEMBERS_ADD_JOB_STATUS` |
| Action | What it does | Slug |
| ------------------ | --------------------------------------------------- | ---------------------------- |
| Get temporary link | Get a one-click temporary (expiring) download link. | `DROPBOX_GET_TEMPORARY_LINK` |
| Action | What it does | Slug |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| Check remove member | Check the status of an asynchronous remove folder member job in Dropbox. | `DROPBOX_CHECK_REMOVE_MEMBER` |
| Get team members info | Retrieve information about multiple team members in a single request. | `DROPBOX_GET_TEAM_MEMBERS_INFO` |
| List file members | Obtain the members who have been invited to a file, both inherited and uninherited members. | `DROPBOX_LIST_FILE_MEMBERS` |
| List file members batch | Get members of multiple files at once. | `DROPBOX_LIST_FILE_MEMBERS_BATCH` |
| List folder members | List members of a shared folder, including users, groups, and invitees. | `DROPBOX_LIST_FOLDER_MEMBERS` |
| List folder members continue | Continue paginating through shared folder members using a cursor from list\_folder\_members. | `DROPBOX_LIST_FOLDER_MEMBERS_CONTINUE` |
| List team group members | List members of a Dropbox team group. | `DROPBOX_LIST_TEAM_GROUP_MEMBERS` |
| List team groups members continue | Continue listing team group members using a cursor from team/groups/members/list. | `DROPBOX_LIST_TEAM_GROUPS_MEMBERS_CONTINUE` |
| List team member devices | List all device sessions of a team's member, including web sessions, desktop clients, and mobile clients. | `DROPBOX_LIST_TEAM_MEMBER_DEVICES` |
| List team members | List members of a Dropbox team. | `DROPBOX_LIST_TEAM_MEMBERS` |
| List team members continue | Continue listing team members using a cursor from team/members/list or team/members/list/continue\_v2. | `DROPBOX_LIST_TEAM_MEMBERS_CONTINUE` |
| Action | What it does | Slug |
| ---------------------- | ---------------------------------------------------------------------- | -------------------------------- |
| Search file properties | Search across property templates for particular property field values. | `DROPBOX_SEARCH_FILE_PROPERTIES` |
| Action | What it does | Slug |
| ------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------- |
| Get available team member roles | Retrieve all available team member roles for the connected Dropbox team. | `DROPBOX_GET_AVAILABLE_TEAM_MEMBER_ROLES` |
| Action | What it does | Slug |
| ----------------- | -------------------------------------------------------------------------------------------------------- | --------------------------- |
| Get openid config | Retrieve Dropbox's OpenID Connect discovery document describing supported OAuth 2.0 and OIDC parameters. | `DROPBOX_GET_OPENID_CONFIG` |
| Action | What it does | Slug |
| ------------------------ | ----------------------------------------------------------------------------- | ---------------------------------- |
| Get shared link metadata | Resolve a Dropbox shared link URL into structured metadata. | `DROPBOX_GET_SHARED_LINK_METADATA` |
| List shared links | List existing shared links for the current user, optionally filtered by path. | `DROPBOX_LIST_SHARED_LINKS` |
| Action | What it does | Slug |
| ------------- | --------------------------------------------------------- | ----------------------- |
| Get file tags | Get list of tags assigned to files or folders in Dropbox. | `DROPBOX_GET_FILE_TAGS` |
| Action | What it does | Slug |
| ------------------------------------ | ------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
| Get team info | Retrieve information about a Dropbox team. | `DROPBOX_GET_TEAM_INFO` |
| List team devices | List all device sessions of a team including web sessions, desktop clients, and mobile clients. | `DROPBOX_LIST_TEAM_DEVICES` |
| List team namespaces | List all team-accessible namespaces in a Dropbox Business team. | `DROPBOX_LIST_TEAM_NAMESPACES` |
| List team namespaces continue | Continue paginating through team-accessible namespaces using a cursor from team/namespaces/list. | `DROPBOX_LIST_TEAM_NAMESPACES_CONTINUE` |
| List team sharing allowlist continue | Continue paginating through team sharing allowlist entries using a cursor. | `DROPBOX_LIST_TEAM_SHARING_ALLOWLIST_CONTINUE` |
| Action | What it does | Slug |
| ---------------------------- | ------------------------------------------------------------ | -------------------------------------- |
| Get team properties template | Get the schema for a specified property template for a team. | `DROPBOX_GET_TEAM_PROPERTIES_TEMPLATE` |
| List templates for team | List all property templates for a team. | `DROPBOX_LIST_TEMPLATES_FOR_TEAM` |
| List user templates | Get the template identifiers for a user. | `DROPBOX_LIST_USER_TEMPLATES` |
| Action | What it does | Slug |
| ------------------- | ------------------------------------------------------------------ | ----------------------------- |
| Get thumbnail | Get a thumbnail for an image file. | `DROPBOX_GET_THUMBNAIL` |
| Get thumbnail batch | Get thumbnails for multiple image files in a single batch request. | `DROPBOX_GET_THUMBNAIL_BATCH` |
| Get thumbnail v2 | Get a thumbnail for an image file. | `DROPBOX_GET_THUMBNAIL_V2` |
| Action | What it does | Slug |
| ---------------------------- | ------------------------------------------------------------------- | -------------------------------------- |
| Get space usage | Get space usage information for the current user's Dropbox account. | `DROPBOX_GET_SPACE_USAGE` |
| Get team member custom quota | Retrieve custom storage quotas for team members. | `DROPBOX_GET_TEAM_MEMBER_CUSTOM_QUOTA` |
| Action | What it does | Slug |
| --------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Check user | Test Dropbox API connection and validate access token by echoing back a supplied string. | `DROPBOX_CHECK_USER` |
| List excluded users continue | Paginate through team members excluded from space limits using a cursor from a previous list call. | `DROPBOX_LIST_EXCLUDED_USERS_CONTINUE` |
| List member space limits excluded users | List team members excluded from space limits. | `DROPBOX_LIST_MEMBER_SPACE_LIMITS_EXCLUDED_USERS` |
| Action | What it does | Slug |
| ------------------- | ----------------------------------------- | ----------------------------- |
| List file revisions | Retrieve the revision history for a file. | `DROPBOX_LIST_FILE_REVISIONS` |
| Action | What it does | Slug |
| ---------------------- | ------------------------------------------------------------------------------------------- | -------------------------------- |
| Check copy batch | Check the status of an asynchronous copy batch job in Dropbox. | `DROPBOX_CHECK_COPY_BATCH` |
| Check delete batch | Check the status of an asynchronous delete batch job in Dropbox. | `DROPBOX_CHECK_DELETE_BATCH` |
| Check move batch | Check the status of an asynchronous move batch job. | `DROPBOX_CHECK_MOVE_BATCH` |
| Check save URL status | Check the status of a save\_url job in Dropbox. | `DROPBOX_CHECK_SAVE_URL_STATUS` |
| Download ZIP | Download a folder from Dropbox as a zip file. | `DROPBOX_DOWNLOAD_ZIP` |
| Get about me | Get information about the current user's Dropbox account. | `DROPBOX_GET_ABOUT_ME` |
| Get copy reference | Get a copy reference to a file or folder. | `DROPBOX_GET_COPY_REFERENCE` |
| Get jwks | Retrieve JSON Web Key Set containing public verification keys for Dropbox signed ID tokens. | `DROPBOX_GET_JWKS` |
| Get metadata | Fetch metadata for a file or folder by path. | `DROPBOX_GET_METADATA` |
| Get metadata alpha | Fetch metadata for a file or folder using the alpha endpoint. | `DROPBOX_GET_METADATA_ALPHA` |
| List sharing allowlist | List Approve List entries for a team from newest to oldest. | `DROPBOX_LIST_SHARING_ALLOWLIST` |
| Search continue | Fetch the next page of search results from a previous Dropbox search. | `DROPBOX_SEARCH_CONTINUE` |
Agents can use 162 of the 178 Dropbox actions at this level: everything in **Read-only**, plus:
* Create, update, and share folders
* Create, update, delete, and share files
* Update, start, and stop sessions
* Create and update members
* Create and update properties
* Create and update documents
* Create and send email addresses
* Create and update groups
* Update photos
* Update settings
* Create and update templates
* Update and delete usage
The 68 actions that this level adds to **Read-only**:
| Action | What it does | Slug |
| -------- | ------------ | ------------------ |
| Who am I | | `DROPBOX_WHO_AM_I` |
| Action | What it does | Slug |
| --------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------- |
| Create paper document | Creates a new Dropbox Paper document at the specified path using HTML or Markdown content. | `DROPBOX_CREATE_PAPER_DOCUMENT` |
| Update paper document | Update an existing Dropbox Paper document with new content in Markdown, HTML, or plain text format. | `DROPBOX_UPDATE_PAPER_DOCUMENT` |
| Action | What it does | Slug |
| ----------------------------------- | ----------------------------------------------------------- | --------------------------------------------- |
| Add team members secondary emails | Add secondary email addresses to Dropbox team members. | `DROPBOX_ADD_TEAM_MEMBERS_SECONDARY_EMAILS` |
| Resend secondary email verification | Resend secondary email verification emails to team members. | `DROPBOX_RESEND_SECONDARY_EMAIL_VERIFICATION` |
| Send team member welcome email | Send a welcome email to a pending team member. | `DROPBOX_SEND_TEAM_MEMBER_WELCOME_EMAIL` |
| Action | What it does | Slug |
| --------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| Alpha upload file | Upload a new file to Dropbox using the alpha upload endpoint. | `DROPBOX_ALPHA_UPLOAD_FILE` |
| Copy file or folder | Copy a file or folder to a different location in Dropbox. | `DROPBOX_COPY_FILE_OR_FOLDER` |
| Create file request | Create a new file request in Dropbox. | `DROPBOX_CREATE_FILE_REQUEST` |
| Delete file | Delete a file or folder at the specified path in Dropbox. | `DROPBOX_DELETE_FILE` |
| Delete file or folder | DEPRECATED: Use DeleteFile instead. | `DROPBOX_DELETE_FILE_OR_FOLDER` |
| Move file or folder | | `DROPBOX_MOVE_FILE_OR_FOLDER` |
| Restore file | Restore a specific revision of a file to the given path in Dropbox. | `DROPBOX_RESTORE_FILE` |
| Unlock file batch | Unlock multiple files at specified paths in a single batch operation. | `DROPBOX_UNLOCK_FILE_BATCH` |
| Unshare file | Remove all members from a Dropbox file. | `DROPBOX_UNSHARE_FILE` |
| Update file request | Update an existing file request in Dropbox. | `DROPBOX_UPDATE_FILE_REQUEST` |
| Upload file | Uploads a file (up to \~150 MB) to a specified path in the user's Dropbox, with options for handling existing files. | `DROPBOX_UPLOAD_FILE` |
| Action | What it does | Slug |
| -------------------- | ---------------------------------------------------------------------------------- | ------------------------------ |
| Activate team folder | Activate an archived team folder. | `DROPBOX_ACTIVATE_TEAM_FOLDER` |
| Create folder | Create a new folder at a specified path in Dropbox. | `DROPBOX_CREATE_FOLDER` |
| Create folder batch | Create multiple folders at once in Dropbox. | `DROPBOX_CREATE_FOLDER_BATCH` |
| Create paper folder | Create a new Paper folder with the provided info. | `DROPBOX_CREATE_PAPER_FOLDER` |
| Create team folder | Create a new, active team folder with no members in Dropbox. | `DROPBOX_CREATE_TEAM_FOLDER` |
| Mount folder | Mount a shared folder for the current user after they have been added as a member. | `DROPBOX_MOUNT_FOLDER` |
| Rename team folder | Rename an existing team folder in Dropbox. | `DROPBOX_RENAME_TEAM_FOLDER` |
| Share folder | Share a folder with collaborators in Dropbox. | `DROPBOX_SHARE_FOLDER` |
| Unmount folder | Unmount a shared folder for the current user. | `DROPBOX_UNMOUNT_FOLDER` |
| Unshare folder | Allow a shared folder owner to unshare the folder. | `DROPBOX_UNSHARE_FOLDER` |
| Action | What it does | Slug |
| ----------------- | ---------------------------------------------------------------- | --------------------------- |
| Create team group | Create a new, empty team group in Dropbox with a specified name. | `DROPBOX_CREATE_TEAM_GROUP` |
| Update team group | Update a team group's name, external ID, and/or management type. | `DROPBOX_UPDATE_TEAM_GROUP` |
| Action | What it does | Slug |
| ------------------------- | --------------------------------------------------------------------- | ----------------------------------- |
| Get temporary upload link | Get a one-time use temporary upload link to upload a file to Dropbox. | `DROPBOX_GET_TEMPORARY_UPLOAD_LINK` |
| Action | What it does | Slug |
| ------------------------ | ------------------------------------------------------------------------ | ---------------------------------- |
| Add file member | Add specified members to a Dropbox file with configurable access levels. | `DROPBOX_ADD_FILE_MEMBER` |
| Add folder member action | Add members to a shared folder with specified access levels. | `DROPBOX_ADD_FOLDER_MEMBER_ACTION` |
| Add team group members | Add members to a team group with specified access levels. | `DROPBOX_ADD_TEAM_GROUP_MEMBERS` |
| Add team members | Add new members to a Dropbox team. | `DROPBOX_ADD_TEAM_MEMBERS` |
| Update file member | Change a member's access level on a shared file. | `DROPBOX_UPDATE_FILE_MEMBER` |
| Update folder member | Update another member's permissions in a shared folder. | `DROPBOX_UPDATE_FOLDER_MEMBER` |
| Action | What it does | Slug |
| -------------------------------- | ------------------------------------------------------------- | ------------------------------------------ |
| Set profile photo | Set the profile photo for the current user's Dropbox account. | `DROPBOX_SET_PROFILE_PHOTO` |
| Update team member profile photo | Update a team member's profile photo. | `DROPBOX_UPDATE_TEAM_MEMBER_PROFILE_PHOTO` |
| Action | What it does | Slug |
| -------------------- | ------------------------------------------------ | ------------------------------ |
| Update folder policy | Update the sharing policies for a shared folder. | `DROPBOX_UPDATE_FOLDER_POLICY` |
| Action | What it does | Slug |
| -------------------------- | ------------------------------------------- | ------------------------------------ |
| Update team member profile | Update a team member's profile information. | `DROPBOX_UPDATE_TEAM_MEMBER_PROFILE` |
| Action | What it does | Slug |
| ------------------------- | ------------------------------------------------------------------------- | ----------------------------------- |
| Add file properties | Add custom properties to a Dropbox file using a filled property template. | `DROPBOX_ADD_FILE_PROPERTIES` |
| Overwrite file properties | Overwrite property groups associated with a file or folder. | `DROPBOX_OVERWRITE_FILE_PROPERTIES` |
| Update file properties | Update custom properties on a file or folder in Dropbox. | `DROPBOX_UPDATE_FILE_PROPERTIES` |
| Action | What it does | Slug |
| ------------------------------------ | ----------------------------------------- | ---------------------------------------------- |
| Update team member admin permissions | Update a team member's admin permissions. | `DROPBOX_UPDATE_TEAM_MEMBER_ADMIN_PERMISSIONS` |
| Action | What it does | Slug |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| Append upload session | Append more data to an existing upload session. | `DROPBOX_APPEND_UPLOAD_SESSION` |
| Append upload session batch | Append data to multiple upload sessions in a single request. | `DROPBOX_APPEND_UPLOAD_SESSION_BATCH` |
| Finish upload session | Finish an upload session and save the uploaded data to the given file path. | `DROPBOX_FINISH_UPLOAD_SESSION` |
| Finish upload session batch | Commit many files at once into a user's Dropbox after uploading file contents via upload\_session/start and upload\_session/append. | `DROPBOX_FINISH_UPLOAD_SESSION_BATCH` |
| Start upload session | Start a new upload session with the given data. | `DROPBOX_START_UPLOAD_SESSION` |
| Start upload session batch | Start a batch of upload sessions. | `DROPBOX_START_UPLOAD_SESSION_BATCH` |
| Action | What it does | Slug |
| -------------------------------- | --------------------------------------------------------------------- | ------------------------------------------ |
| Modify shared link settings | Modify settings of an existing Dropbox shared link. | `DROPBOX_MODIFY_SHARED_LINK_SETTINGS` |
| Update team folder sync settings | Update the sync settings on a team folder or its contents in Dropbox. | `DROPBOX_UPDATE_TEAM_FOLDER_SYNC_SETTINGS` |
| Action | What it does | Slug |
| ------------------------- | --------------------------------------------------------------------- | ----------------------------------- |
| Create shared link | Create a stable, long-lived shared link for a Dropbox file or folder. | `DROPBOX_CREATE_SHARED_LINK` |
| Create shared link simple | DEPRECATED: Use CreateSharedLinkV2 instead. | `DROPBOX_CREATE_SHARED_LINK_SIMPLE` |
| Action | What it does | Slug |
| ------------- | ----------------------------------------- | ----------------------- |
| Add file tags | Add a tag to a file or folder in Dropbox. | `DROPBOX_ADD_FILE_TAGS` |
| Action | What it does | Slug |
| --------------------------------- | ------------------------------------------------- | ------------------------------------------- |
| Add team properties template | Add a property template for a team in Dropbox. | `DROPBOX_ADD_TEAM_PROPERTIES_TEMPLATE` |
| Update property template for team | Update a property template for a team in Dropbox. | `DROPBOX_UPDATE_PROPERTY_TEMPLATE_FOR_TEAM` |
| Action | What it does | Slug |
| ------------------------------- | ---------------------------------------------- | ----------------------------------------- |
| Update group member access type | Change a member's access type in a team group. | `DROPBOX_UPDATE_GROUP_MEMBER_ACCESS_TYPE` |
| Action | What it does | Slug |
| ------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------- |
| Remove team member custom quota | Remove custom storage quota for team members, reverting them to the team's default quota. | `DROPBOX_REMOVE_TEAM_MEMBER_CUSTOM_QUOTA` |
| Set team member custom quota | Set custom storage quotas for team members in Dropbox. | `DROPBOX_SET_TEAM_MEMBER_CUSTOM_QUOTA` |
| Action | What it does | Slug |
| ---------------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------- |
| Add member space limits excluded users | Add users to the team's space limits exclusion list in Dropbox. | `DROPBOX_ADD_MEMBER_SPACE_LIMITS_EXCLUDED_USERS` |
| Remove team member space limits excluded users | Remove users from the member space limits excluded users list. | `DROPBOX_REMOVE_TEAM_MEMBER_SPACE_LIMITS_EXCLUDED_USERS` |
| Action | What it does | Slug |
| --------------------- | ------------------------------------------------------------------------- | ------------------------------- |
| Add sharing allowlist | Add domains or email addresses to the team sharing allowlist. | `DROPBOX_ADD_SHARING_ALLOWLIST` |
| Copy batch | Copy multiple files or folders to different locations at once in Dropbox. | `DROPBOX_COPY_BATCH` |
| Delete batch | Delete multiple files or folders at once in Dropbox. | `DROPBOX_DELETE_BATCH` |
| Move batch | Move multiple files or folders to different locations at once in Dropbox. | `DROPBOX_MOVE_BATCH` |
| Save copy reference | Save a copy reference to the user's Dropbox. | `DROPBOX_SAVE_COPY_REFERENCE` |
| Save URL | Save a file to Dropbox directly from a public URL via server-side fetch. | `DROPBOX_SAVE_URL` |
Agents can use 178 of the 178 Dropbox actions at this level: everything in **Read + write**, plus:
* Delete members
* Delete contacts
* Delete email addresses
* Archive folders
* Delete groups
* Delete photos
* Delete properties
* Update shared links
* Delete tags
* Delete templates
The 16 actions that this level adds to **Read + write**:
| Works on | Action | What it does | Slug |
| ------------------- | ---------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------- |
| **Contacts** | Delete manual contacts batch | Delete specific manually added contacts from Dropbox by their email addresses. | `DROPBOX_DELETE_MANUAL_CONTACTS_BATCH` |
| **Email addresses** | Delete team members secondary emails | Delete secondary email addresses from Dropbox team members. | `DROPBOX_DELETE_TEAM_MEMBERS_SECONDARY_EMAILS` |
| **Files** | Delete all closed file requests | Delete all closed file requests owned by the current user. | `DROPBOX_DELETE_ALL_CLOSED_FILE_REQUESTS` |
| | Delete file requests | Delete a batch of closed file requests in Dropbox. | `DROPBOX_DELETE_FILE_REQUESTS` |
| **Folders** | Archive team folder | Archive an active team folder in Dropbox. | `DROPBOX_ARCHIVE_TEAM_FOLDER` |
| | Delete team folder permanently | Permanently delete an archived team folder in Dropbox. | `DROPBOX_DELETE_TEAM_FOLDER_PERMANENTLY` |
| **Groups** | Delete team group | Delete a Dropbox team group. | `DROPBOX_DELETE_TEAM_GROUP` |
| **Members** | Remove file member | Remove a specified member from a file's sharing permissions. | `DROPBOX_REMOVE_FILE_MEMBER` |
| | Remove folder member | Remove a member from a shared folder. | `DROPBOX_REMOVE_FOLDER_MEMBER` |
| | Remove group members | Remove members from a Dropbox team group. | `DROPBOX_REMOVE_GROUP_MEMBERS` |
| **Photos** | Delete team member profile photo | Delete a team member's profile photo. | `DROPBOX_DELETE_TEAM_MEMBER_PROFILE_PHOTO` |
| **Properties** | Remove file properties | Permanently remove specified property groups from a file or folder. | `DROPBOX_REMOVE_FILE_PROPERTIES` |
| **Shared links** | Revoke shared link | Revoke a Dropbox shared link. | `DROPBOX_REVOKE_SHARED_LINK` |
| **Tags** | Remove file tag | Remove a tag from a file or folder in Dropbox. | `DROPBOX_REMOVE_FILE_TAG` |
| **Templates** | Remove file properties template for team | Remove a property template from a team. | `DROPBOX_REMOVE_FILE_PROPERTIES_TEMPLATE_FOR_TEAM` |
| **Other actions** | Remove sharing allowlist | Remove domains or email addresses from the team sharing allowlist. | `DROPBOX_REMOVE_SHARING_ALLOWLIST` |
## Connect Dropbox
Before you start:
* You need a Dropbox account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.
Open **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **Dropbox** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, choose an access level. This level applies to every agent.
Click **Connect Dropbox**. The Dropbox sign-in page opens in a new tab.
Sign in to Dropbox and approve the request.
Check that it works: Dropbox shows under **YOUR CONNECTIONS**, with a row for the account and its access level.
## Change the access level
1. Under **YOUR CONNECTIONS**, find the Dropbox account.
2. Open the account menu (⋯) and click **Manage scope**.
3. Under **Default scope**, choose the new level.
4. Click **Save access**.
The change does not need a new sign-in. Agents get the new level from their next call.
## Set access for one agent
Every agent uses the account's level unless you set something else for it. You can narrow one agent to a lower level, or block it.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Dropbox account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose the **Default** option to follow the account's level, choose a lower level, or choose **No access**.
5. Click **Save access**.
An agent never gets more than the account's level, even if you choose a higher level for it. Changes apply from the agent's next call. An agent with **No access** does not see the account.
## Use more than one Dropbox account
Click **+ Account** on the Dropbox card to connect another account. Agents use the primary account unless they are asked to use a specific one.
* After you click **+ Account**, follow the connect steps above.
* Each account has its own access level.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.
## Reconnect or disconnect
Reconnect when the connection has expired, or when you need to change what the account can reach on the Dropbox side:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Dropbox**.
3. Sign in to Dropbox and approve the request.
Reconnect signs in to the same account again. It does not add a second connection.
Open the account menu (⋯) on the Dropbox account and click **Disconnect**. Agents lose access to that account at once.
**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Dropbox account becomes primary.
## Costs
Dropbox actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).
## Troubleshooting
An agent reports that an action is not allowed on this account.
* Cause: the action is outside the account's access level, or outside the level you set for that agent.
* Fix: choose a higher level in **Manage scope**, or change the agent's row under **Per-agent access**.
An agent says it has no access to Dropbox, or it does not see the account.
* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.
Connecting or saving fails with "Your subscription isn't active."
* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).
An agent says the Dropbox connection has expired.
* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.
## Common questions
Each Dropbox account has an access level: **Read-only**, **Read + write**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
Click **+ Account** on the Dropbox card to connect another account. Agents use the primary account unless they are asked to use a specific one.
Open the account menu (⋯) on the Dropbox account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.