Box
Run Box for IT in plain language - users, groups, folder and file access, collaborations, shared links, and trash restores.
Dex connects to one Box enterprise through a Box Platform App (Client Credentials Grant) so admins can manage Box content and people conversationally - create and offboard users with content transfer, manage groups and memberships, see who has access to a folder or file, add or change collaborations, create and tighten shared links, restore items from trash, roll files back to older versions, and review admin events, device pins, storage policies, Governance holds, and Box Sign requests. Employees can self-serve through Dex Go: find their own files, see who has access, restore a deleted item, request access, create a shared link, and check their storage. Every write is approval-gated, and all calls run as the app's Service Account, so Box only reaches folders shared with it.
What Dex does with Box
Dex handles both admin workflows and employee self-service — all policy-guardrailed and audit-logged.
For admins (Dex Pro)
- Find and read managed users - role, status, quota, storage used, group memberships, and email aliases
- Create and update users, change role between user and co-admin, deactivate or reactivate, and adjust quota - with approval
- Offboard a leaver end-to-end: sign them out, deactivate, transfer owned content to a manager or archive account, and clear device pins - each step approval-gated
- Manage groups and memberships, and see what folders and files a group can reach
- Show who has access to a folder or file, including inherited access up the folder path and pending invites
- Add, change, or remove collaborations - flagging external people and ownership transfers in the approval request
- Create, rename, move, copy, lock, trash, and restore folders and files, and roll a file back to an older version - with approval
- Create and tighten shared links, calling out open (anyone-with-the-link) links in the approval request
- Review admin events, device pins, storage policies, Governance legal holds and retention, and Box Sign requests
For employees (self-service)
- Find your own files and folders and get the Box web link
- See who has access to an item you own or collaborate on
- Restore a file or folder you deleted from trash - with approval
- Request access to a folder, or share one of your items with a coworker - with approval
- Create or change a shared link on an item you own or edit - with approval
- Create a folder and roll a file back to an older version - with approval
- Check how much Box storage you are using
Just ask Dex
Your team types a request in plain language. Dex investigates, plans, and executes — with the right guardrails.
Admin prompts
- >Offboard dana@example.com - sign them out, deactivate, and transfer their content to their manager
- >Who has access to the Finance folder, including anyone inheriting from parent folders?
- >Add sam@example.com as a viewer on the Q4 Marketing folder
- >Create a company shared link on the brochure and set it to expire in 30 days
- >Show me failed sign-ins in Box over the last 7 days
Employee prompts
- >Where is my Q3 deck?
- >I deleted a file called Budget.xlsx yesterday - can you get it back?
- >Who has access to my Project Apollo folder?
- >Make a company shared link for my brochure
- >How much Box storage am I using?
Policy actions
Every action Dex can take on Box is declared, scoped, and guardrailed. Admins control which apply, who approves them, and whether they're limited to self-service.
| Action | What it does |
|---|---|
box_list_users | List or search enterprise users |
box_get_user | Read one user - status, role, quota, storage used |
box_create_user | Create a managed user |
box_update_user | Update a user: profile, role user/co-admin, status active/inactive, quota, or remove from enterprise |
box_delete_user | Delete a user (disabled by default; transfer owned content first) |
box_transfer_owned_content | Move everything a user owns into another user's account (offboarding) |
box_terminate_user_sessions | Sign specific users out of every Box session |
box_invite_user | Invite an existing Box user into the enterprise |
box_list_groups | List or search enterprise groups and their members and collaborations |
box_create_group | Create a group |
box_update_group | Rename a group or change who can invite to or see it |
box_delete_group | Delete a group (its collaborations go with it) |
box_add_group_member | Add a user to a group as member or group admin |
box_update_group_membership | Change a membership role or its permissions |
box_remove_group_member | Remove a user from a group |
box_list_folder_collaborations | List who has access to a folder or file, including pending invites |
box_add_collaboration | Give a user or group (internal or external) a role on a folder or file |
box_update_collaboration | Change a collaborator's role (owner = ownership transfer), expiry, or status |
box_remove_collaboration | Remove a collaborator's access |
box_search | Search files, folders, and web links |
box_get_folder | Read a folder or file and list a folder's contents and versions |
box_create_folder | Create a folder under a parent |
box_update_folder | Rename, move, describe, tag, or lock a folder and manage its shared link |
box_trash_folder | Move a folder to the trash |
box_restore_folder | Restore a folder from the trash |
box_permanently_delete_folder | Permanently delete a trashed folder (disabled by default, irreversible) |
box_update_file | Rename, move, describe, tag, lock, or manage the shared link of a file |
box_trash_file | Move a file to the trash |
box_restore_file | Restore a file from the trash |
box_permanently_delete_file | Permanently delete a trashed file (disabled by default, irreversible) |
box_promote_file_version | Restore an older version of a file as the current one |
box_list_events | Read enterprise events and admin logs |
box_delete_device_pin | Remove a device pin (the device must re-pin on next sign-in) |
box_assign_storage_policy | Assign a storage (data residency) policy to a user (disabled by default) |
box_assign_legal_hold_policy | Put a user, folder, or file on legal hold (disabled by default) |
box_assign_retention_policy | Assign a retention policy (disabled by default) |
box_create_sign_request | Send a document for signature via Box Sign |
box_cancel_sign_request | Cancel a Box Sign request |
How to configure Box
Onboarding takes minutes. Dex validates your credentials before saving them.
Setup steps
- 1In the Box Developer Console, create a Platform App using Server Authentication (Client Credentials Grant) with App Access Level set to App + Enterprise Access.
- 2Enable the scopes Dex needs: read and write all files and folders, manage users, manage groups, manage enterprise properties, and manage retention/legal holds only if the enterprise has Box Governance.
- 3Submit the app, then have a Box admin authorize it in the Admin Console under Integrations > Platform Apps Manager (re-authorize after every scope change).
- 4Share the department and company folders IT manages with the app's Service Account (AutomationUser_...@boxdevedition.com) as Co-owner or Editor - content it is not collaborated on is invisible to Dex.
- 5In Dex, enable the Box integration and paste the Enterprise ID, Client ID, and Client Secret. Dex validates with a live read of the Service Account before saving.
Credentials required
- enterprise_id
- Numeric Box Enterprise ID (Admin Console > Account & Billing > Account Information > Enterprise ID) - non-secret
- client_id
- The Platform App's Client ID (Developer Console > the app > Configuration > OAuth 2.0 Credentials)
- client_secret
- The Platform App's Client Secret from the same page (may need 2FA to reveal)
Requirements
- •A Box enterprise and a Platform App using Server Authentication (Client Credentials Grant), authorized in the Admin Console
- •App Access Level set to App + Enterprise Access with the scopes Dex needs
- •The Service Account shared as Co-owner or Editor on the folders IT manages - Box only reaches content shared with it
- •Admin events, device pins, and storage policies need the Manage enterprise properties scope; legal holds and retention need Box Governance
- •One Dex connection maps to one Box enterprise (per-tenant app, no shared master credential)
Related integrations
- Collaboration
Egnyte
Browse your Egnyte Connect content and directory from Dex - folders, file metadata, and users for one tenant.
Learn more → - Directory & Identity
SharePoint
Grant, audit, and query SharePoint sites and lists through Microsoft Graph.
Learn more → - Directory & Identity
Google Workspace
Run Google Workspace user, group, and org-unit operations in natural language.
Learn more →
See Dex run Box
Book a 30-minute walkthrough with our team and see how autonomous IT works in your environment — or get started for free.