watermint toolbox - The multi-purpose utility command-line tool for web services

Member management commands

Information commands

Below commands are to retrieve information about team members.

Command Description
member list List team member(s)
member feature List member feature settings
member folder list List folders for each member
member quota list List team member quota
member quota usage List team member storage usage
team activity user Activities log per user

Basic management commands

Below commands are for managing team member accounts. Those commands are for a bulk operation by a CSV file.

Command Description
member invite Invite member(s)
member delete Delete members
member detach Convert Dropbox Business accounts to a Basic account
member reinvite Reinvite invited status members to the team
member update email Member email operation
member update profile Update member profile
member update visible Disable directory restriction to members
member update invisible Enable directory restriction to members
member quota update Update team member quota

Member profile setting commands

Member profile commands are for bulk updating member profile information. If you need to update the members’ email addresses, use the ‘member update email command. The command 'member update email receives a CSV file to bulk update email addresses. If you need to update the member’s display name, use the ‘member update profile` command.

Command Description
member update email Member email operation
member update profile Update member profile

Member storage quota control commands

You can see existing member storage quota setting or usage by the member quota list and member quota usage command. If you need to update member quota, use the member quota update command. The command member quota update receives CSV input for bulk updating storage quota setting.

Command Description
member quota list List team member quota
member quota usage List team member storage usage
member quota update Update team member quota

There are two types of commands available for suspending/unsuspending members. If you wanted to suspend/unsuspend a member one by one, please use member suspend or member unsuspend. Otherwise, if you want to suspend/unsuspend members through a CSV file, please use the member batch suspend or member batch unsuspend command.

Suspend/unsuspend a member

Command Description
member suspend Suspend a member
member unsuspend Unsuspend a member
member batch suspend Bulk suspend members
member batch unsuspend Bulk unsuspend members

Directory restriction commands

Directory restriction is the Dropbox Business feature to hide a member from others. Below commands update this setting to hide or unhide members from others.

Command Description
member update visible Disable directory restriction to members
member update invisible Enable directory restriction to members

Group commands

Group management commands

Below commands are for managing groups.

Command Description
group add Create new group
group batch add Bulk adding groups
group batch delete Delete groups
group delete Delete group
group list List group(s)
group rename Rename the group
group update type Update group management type

Group member management commands

You can add/delete/update group members by the below commands. If you want to add/delete/update group members by CSV file, use group member batch add, group member batch delete, or group member batch delete.

Command Description
group member add Add a member to the group
group member delete Delete a member from the group
group member list List members of groups
group member batch add Bulk add members into groups
group member batch delete Delete members from groups
group member batch update Add or delete members from groups

Find and delete unused groups

There are two commands to find unused groups. The first command is group list. The command group list will report the number of members of each group. If it’s zero, a group is not currently used to adding permission to folders. If you want to see which folder uses each group, use the command group folder list. group folder list will report the group to folder mapping. The report group_with_no_folders will show groups with no folders. You can safely remove groups once if you check both the number of members and folders. After confirmation, you can bulk delete groups by using the command group batch delete.

Command Description
group list List group(s)
group folder list List folders of each group
group batch delete Delete groups

Team content commands

Admins’ can handle team folders, shared folders or member’s folder content thru Dropbox Business API. Please be careful to use those commands. The namespace is the term in Dropbox API that is for manage folder permissions or settings. Folder types such as shared folders, team folders, or nested folder in a team folder, member’s root folder or member’s app folder are all managed as a namespace. The namespace commands can handle all types of folders, including team folders and member’s folder. But commands for specific folder types have more features or detailed information in the report.

Team folder operation commands

You can create, archive or permanently delete team folders by using the below commands. Please consider using teamfolder batch commands if you need to handle multiple team folders.

Command Description
teamfolder add Add team folder to the team
teamfolder archive Archive team folder
teamfolder batch archive Archiving team folders
teamfolder batch permdelete Permanently delete team folders
teamfolder batch replication Batch replication of team folders
teamfolder file size Calculate size of team folders
teamfolder list List team folder(s)
teamfolder permdelete Permanently delete team folder
teamfolder policy list List policies of team folders
teamfolder sync setting list List team folder sync settings
teamfolder sync setting update Batch update team folder sync settings

Team folder permission commands

You can bulk add or delete members into team folders or sub-folders of a team folder through the below commands.

Command Description
teamfolder member list List team folder members
teamfolder member add Batch adding users/groups to team folders
teamfolder member delete Batch removing users/groups from team folders

Team folder & shared folder commands

The below commands are for both team folders and shared folders of the team. If you wanted to know who are actually uses specific folders, please consider using the command team content mount list. Mount is a status a user add a shared folder to his/her Dropbox account.

Command Description
team content member list List team folder & shared folder members
team content member size Count number of members of team folders and shared folders
team content mount list List all mounted/unmounted shared folders of team members.
team content policy list List policies of team folders and shared folders in the team

Team space commands

Command for team space.

Command Description
teamspace asadmin file list List files and folders in team space run as admin
teamspace asadmin folder add Create top level folder in the team space
teamspace asadmin folder delete Delete top level folder of the team space
teamspace asadmin folder permdelete Permanently delete top level folder of the team space
teamspace asadmin member list List top level folder members
teamspace file list List files and folders in team space

Namespace commands

Command Description
team namespace list List all namespaces of the team
team namespace summary Report team namespace status summary.
team namespace file list List all files and folders of the team namespaces
team namespace file size List all files and folders of the team namespaces
team namespace member list List members of shared folders and team folders in the team

Team file request commands

Command Description
team filerequest list List all file requests in the team

Member file commands

Command Description
member file permdelete Permanently delete the file or folder at a given path of the team member.

Team shared link commands

The team shared link commands are capable of listing all shared links in the team or update/delete specified shared links.

Command Description
team sharedlink list List of shared links
team sharedlink cap expiry Set expiry cap to shared links in the team
team sharedlink cap visibility Set visibility cap to shared links in the team
team sharedlink update expiry Update expiration date of public shared links within the team
team sharedlink update password Set or update shared link passwords
team sharedlink update visibility Update visibility of shared links
team sharedlink delete links Batch delete shared links
team sharedlink delete member Delete all shared links of the member

Commands team sharedlink update is for setting a value to the shared links. Commands team sharedlink cap is for putting a cap value to the shared links. For example: if you set expiry by team sharedlink update expiry with the expiration date 2021-05-06. The command will update the expiry to 2021-05-06 even if the existing link has a shorter expiration date like 2021-05-04. On the other hand, team sharedlink cap expiry updates links when the link has a longer expiration date, like 2021-05-07.

Similarly, the command team sharedlink cap visibility will restrict visibility only when the link has less protected visibility. For example, if you want to ensure shared links without password to the team only. team sharedlink cap visibility will update visibility to the team only when a link is public and has no password.

List all public links in the team

tbx team sharedlink list -visibility public

Results are stored in CSV, xlsx, and JSON format. You can modify the report for updating shared links. If you are familiar with the command jq, then they can create CSV file directly like below.

tbx team sharedlink list -output json | jq '.sharedlink.url' > all_links.csv

List links filtered by link owner email address:

tbx team sharedlink list -output json | jq 'select(.member.profile.email == "username@example.com") | .sharedlink.url'

Delete all link that listed in the CSV file

tbx team sharedlink delete links -file /PATH/TO/DATA.csv

If you are familiar with jq command, then they can send data directly from the pipe like below (pass single dash - to the -file option to read from standard input).

tbx team sharedlink list -visibility public -output json | tbx team sharedlink delete links -file -

File lock

File lock commands are capable of listing current file locks or releasing file locks as admin.

File lock commands for members

Command Description
member file lock all release Release all locks under the path of the member
member file lock list List locks of the member under the path
member file lock release Release the lock of the path as the member

File lock commands for team folders

Command Description
teamfolder file list List files in team folders
teamfolder file lock all release Release all locks under the path of the team folder
teamfolder file lock list List locks in the team folder
teamfolder file lock release Release lock of the path in the team folder

Activities log commands

The team activities log commands can export activities log by a certain filter or perspective.

Command Description
team activity batch user Scan activities for multiple users
team activity daily event Report activities by day
team activity event Event log
team activity user Activities log per user

Connected applications and devices commands

The below commands can retrieve information about connected devices or applications in the team.

Command Description
team device list List all devices/sessions in the team
team device unlink Unlink device sessions
team linkedapp list List linked applications

Other usecases

External ID

External ID is the attribute that is not shown in any user interface of Dropbox. This attribute is for keep a relationship between Dropbox and identity source (e.g. Active Directory, HR database) by identity management software such as Dropbox AD Connector. In case if you are using Dropbox AD Connector and you built a new Active Directory tree. You may need to clear existing external IDs to disconnect relationships with the old Active Directory tree and the new tree. If you skip clear external IDs, Dropbox AD Connector may unintentionally delete accounts during configuring to the new tree. If you want to see existing external IDs, use the member list command. But the command will not include external ID by default. Please add the option -experiment report_all_columns like below.

tbx member list -experiment report_all_columns
Command Description
member list List team member(s)
member clear externalid Clear external_id of members
member update externalid Update External ID of team members
group list List group(s)
group clear externalid Clear an external ID of a group

Data migration helper commands

Data migration helper commands copies member folders or team folders to another account or team. Please test before using those commands before actual data migration.

Command Description
member folder replication Replicate a folder to another member’s personal folder
member replication Replicate team member files
teamfolder partial replication Partial team folder replication to the other team
teamfolder replication Replicate a team folder to the other team

Team info commands

Command Description
team feature Team feature
team info Team information

Paper commands

Legacy paper commands

Commands for a team’s legacy Paper content. Please see official guide more detail about legacy Paper and migration

Command Description
team content legacypaper count Count number of Paper documents per member
team content legacypaper list List team member Paper documents
team content legacypaper export Export entire team member Paper documents into local path

Team admin commands

Below commands are for managing team admins.

Command Description
team admin list List admin roles of members
team admin role add Add a new role to the member
team admin role clear Remove all admin roles from the member
team admin role delete Remove a role from the member
team admin role list List admin roles of the team
team admin group role add Add the role to members of the group
team admin group role delete Delete the role from all members except of members of the exception group

Commands that run as a team member

You can run a command as a team member. For example, you can upload a file into member’s folder by using team runas file sync batch up.

Command Description
team runas file list List files and folders run as a member
team runas file batch copy Batch copy files/folders as a member
team runas file sync batch up Batch sync up that run as members
team runas sharedfolder list List shared folders run as the member
team runas sharedfolder isolate Unshare owned shared folders and leave from external shared folders run as a member
team runas sharedfolder mount add Add the shared folder to the specified member’s Dropbox
team runas sharedfolder mount delete The specified user unmounts the designated folder.
team runas sharedfolder mount list List all shared folders the specified member mounted
team runas sharedfolder mount mountable List all shared folders the member can mount
team runas sharedfolder batch leave Batch leave from shared folders as a member
team runas sharedfolder batch share Batch share folders for members
team runas sharedfolder batch unshare Batch unshare folders for members
team runas sharedfolder member batch add Batch add members to member’s shared folders
team runas sharedfolder member batch delete Batch delete members from member’s shared folders

Legal hold

With legal holds, admins can place a legal hold on members of their team and view and export all the content that’s been created or modified by those members.

Command Description
team legalhold add Creates new legal hold policy.
team legalhold list Retrieve existing policies
team legalhold member batch update Update member list of legal hold policy
team legalhold member list List members of the legal hold
team legalhold release Releases a legal hold by Id
team legalhold revision list List revisions of the legal hold policy
team legalhold update desc Update description of the legal hold policy
team legalhold update name Update name of the legal hold policy

Notes:

Dropbox Business commands require admin permissions to execute them. Auth tokens must not share with anyone, including Dropbox support.

}