Box
Intelligent content management, secure collaboration, and automated workflows API.
Categories: Cloud Storage, File Management, Collaboration
What you can ask
- Find every file in the
/Contracts/2026folder modified in the last 7 days. - Share the
Q1 Board Deckfolder with view-only access to board@acme.com, link expires in 14 days. - Move all files older than 1 year from
/Activeto/Archive, preserving structure.
Set up
Box is ready to enable, and an admin doesn't need to create anything first.
- Go to Organization > Connectors and find Box.
- Click Enable and choose which tools to allow.
- Each member connects their own account the first time they use it.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
You can also use your own OAuth application instead of the shared one. Create it in the Box developer portal, then enter its details under Use your own OAuth application.
Tools
Box offers 38 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (15)
View and search information without changing it.
| Tool | What it does |
|---|---|
download_file | Download a file's raw content. |
get_collaboration | Retrieve detailed information about a specific Box collaboration including participant roles, permissions, and status |
get_comment | Get a comment |
get_current_user | Retrieve comprehensive profile information for the currently authenticated Box user including account details, storage usage, and role |
get_file_info | Retrieve comprehensive metadata and details for a specific file in Box including name, size, owner, timestamps, and sharing permissions |
get_folder_info | Retrieve comprehensive metadata and details for a specific folder in Box including name, item count, owner, timestamps, and sharing permissions |
get_group | Get group information |
get_task | Get task information |
get_user_info | Retrieve comprehensive profile information for a specific Box user by ID including account details, storage usage, and role assignments |
list_folder_items | List all files and subfolders contained within a Box folder with pagination, sorting, and filtering support |
list_groups | List groups |
list_users | Retrieve a paginated list of all enterprise users in Box with filtering by name, email, or user type |
read_file_text | Read a Box file as text; prefer over download_file to READ. |
search_content | Search for content in Box |
validate_credential | Validate Box credentials. |
Write (9)
Create or send data.
| Tool | What it does |
|---|---|
copy_file | Create a duplicate copy of a file in a specified destination folder with optional rename, preserving original file content and metadata |
copy_folder | Create a duplicate copy of a folder and all its contents recursively to a specified destination folder with optional rename |
create_collaboration | Create a new collaboration to share a Box file or folder with a user or group at a specified permission level |
create_comment | Create a comment |
create_folder | Create a new subfolder within a specified parent folder in Box with a unique name and optional metadata |
create_group | Create a group |
create_task | Create a task |
create_user | Create a new enterprise user account in Box with specified name, email, and access permissions |
upload_file | Upload a new file to a Box folder. |
Delete or overwrite (14)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_collaboration | Permanently remove a Box collaboration to revoke access for a user or group on a shared file or folder |
delete_comment | Delete a comment |
delete_file | Permanently delete a file from Box or move it to trash depending on configuration, removing it from all folders and collaborations |
delete_folder | Delete a folder from Box either recursively with all contents or as empty folder, moving to trash or permanent deletion |
delete_group | Delete a group |
delete_task | Delete a task |
delete_user | Permanently remove a Box enterprise user account and optionally transfer their content to another user |
update_collaboration | Modify the permission level of an existing Box collaboration by changing the assigned role |
update_comment | Update a comment |
update_file_info | Update metadata and properties of an existing file in Box including name, description, and parent folder location |
update_folder_info | Update metadata and properties of an existing folder in Box including name, description, and parent location for reorganization |
update_group | Update group information |
update_task | Update a task |
update_user | Update profile information and settings for an existing Box enterprise user including name, role, and account status |