Skip to main content

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/2026 folder modified in the last 7 days.
  • Share the Q1 Board Deck folder with view-only access to board@acme.com, link expires in 14 days.
  • Move all files older than 1 year from /Active to /Archive, preserving structure.

Set up​

Box is ready to enable, and an admin doesn't need to create anything first.

  1. Go to Organization > Connectors and find Box.
  2. Click Enable and choose which tools to allow.
  3. 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.

ToolWhat it does
download_fileDownload a file's raw content.
get_collaborationRetrieve detailed information about a specific Box collaboration including participant roles, permissions, and status
get_commentGet a comment
get_current_userRetrieve comprehensive profile information for the currently authenticated Box user including account details, storage usage, and role
get_file_infoRetrieve comprehensive metadata and details for a specific file in Box including name, size, owner, timestamps, and sharing permissions
get_folder_infoRetrieve comprehensive metadata and details for a specific folder in Box including name, item count, owner, timestamps, and sharing permissions
get_groupGet group information
get_taskGet task information
get_user_infoRetrieve comprehensive profile information for a specific Box user by ID including account details, storage usage, and role assignments
list_folder_itemsList all files and subfolders contained within a Box folder with pagination, sorting, and filtering support
list_groupsList groups
list_usersRetrieve a paginated list of all enterprise users in Box with filtering by name, email, or user type
read_file_textRead a Box file as text; prefer over download_file to READ.
search_contentSearch for content in Box
validate_credentialValidate Box credentials.

Write (9)​

Create or send data.

ToolWhat it does
copy_fileCreate a duplicate copy of a file in a specified destination folder with optional rename, preserving original file content and metadata
copy_folderCreate a duplicate copy of a folder and all its contents recursively to a specified destination folder with optional rename
create_collaborationCreate a new collaboration to share a Box file or folder with a user or group at a specified permission level
create_commentCreate a comment
create_folderCreate a new subfolder within a specified parent folder in Box with a unique name and optional metadata
create_groupCreate a group
create_taskCreate a task
create_userCreate a new enterprise user account in Box with specified name, email, and access permissions
upload_fileUpload a new file to a Box folder.

Delete or overwrite (14)​

Remove or replace existing data.

ToolWhat it does
delete_collaborationPermanently remove a Box collaboration to revoke access for a user or group on a shared file or folder
delete_commentDelete a comment
delete_filePermanently delete a file from Box or move it to trash depending on configuration, removing it from all folders and collaborations
delete_folderDelete a folder from Box either recursively with all contents or as empty folder, moving to trash or permanent deletion
delete_groupDelete a group
delete_taskDelete a task
delete_userPermanently remove a Box enterprise user account and optionally transfer their content to another user
update_collaborationModify the permission level of an existing Box collaboration by changing the assigned role
update_commentUpdate a comment
update_file_infoUpdate metadata and properties of an existing file in Box including name, description, and parent folder location
update_folder_infoUpdate metadata and properties of an existing folder in Box including name, description, and parent location for reorganization
update_groupUpdate group information
update_taskUpdate a task
update_userUpdate profile information and settings for an existing Box enterprise user including name, role, and account status
⌘J