> This page is for Agent Handler.

> 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