> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Box

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* 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](mailto:board@acme.com), link expires in 14 days.
* Move all files older than 1 year from `/Active` to `/Archive`, preserving structure.

## Available Tools

#### get_collaboration

Retrieve detailed information about a specific Box collaboration including participant roles, permissions, and status

#### create_collaboration

Create a new collaboration to share a Box file or folder with a user or group at a specified permission level

#### update_collaboration

Modify the permission level of an existing Box collaboration by changing the assigned role

#### delete_collaboration

Permanently remove a Box collaboration to revoke access for a user or group on a shared file or folder

#### get_comment

Get a comment

#### create_comment

Create a comment

#### update_comment

Update a comment

#### delete_comment

Delete a comment

#### get_file_info

Retrieve comprehensive metadata and details for a specific file in Box including name, size, owner, timestamps, and sharing permissions

#### download_file

Download the binary content of a file from Box and retrieve content size and download confirmation

#### update_file_info

Update metadata and properties of an existing file in Box including name, description, and parent folder location

#### delete_file

Permanently delete a file from Box or move it to trash depending on configuration, removing it from all folders and collaborations

#### copy_file

Create a duplicate copy of a file in a specified destination folder with optional rename, preserving original file content and metadata

#### get_folder_info

Retrieve comprehensive metadata and details for a specific folder in Box including name, item count, owner, timestamps, and sharing permissions

#### list_folder_items

List all files and subfolders contained within a Box folder with pagination, sorting, and filtering support

#### create_folder

Create a new subfolder within a specified parent folder in Box with a unique name and optional metadata

#### update_folder_info

Update metadata and properties of an existing folder in Box including name, description, and parent location for reorganization

#### delete_folder

Delete a folder from Box either recursively with all contents or as empty folder, moving to trash or permanent deletion

#### copy_folder

Create a duplicate copy of a folder and all its contents recursively to a specified destination folder with optional rename

#### list_groups

List groups

#### get_group

Get group information

#### create_group

Create a group

#### update_group

Update group information

#### delete_group

Delete a group

#### search_content

Search for content in Box

#### get_task

Get task information

#### create_task

Create a task

#### update_task

Update a task

#### delete_task

Delete a task

#### get_current_user

Retrieve comprehensive profile information for the currently authenticated Box user including account details, storage usage, and role

#### get_user_info

Retrieve comprehensive profile information for a specific Box user by ID including account details, storage usage, and role assignments

#### list_users

Retrieve a paginated list of all enterprise users in Box with filtering by name, email, or user type

#### create_user

Create a new enterprise user account in Box with specified name, email, and access permissions

#### update_user

Update profile information and settings for an existing Box enterprise user including name, role, and account status

#### delete_user

Permanently remove a Box enterprise user account and optionally transfer their content to another user