How do I connect Box to Operator?

You authorize Box once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Box without you signing in again.

Can my agent work with my files in Box?

Yes. It can create, read, update, and organize documents and files, and pull one back when you ask. Use it to file new documents in the right place, search for something across your account, or keep Box tidy without doing it by hand.

Do I need to write code or manage Box API keys?

No code and no API keys. You authorize Box through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.

Can my agent use Box together with my other apps?

Yes. The same agent reaches every app you connect, so it can move between Box and tools like Google Drive, Google Docs, Dropbox in one job, reading from one and acting in another without you wiring anything between them.

← All integrations

Connect Box to OpenClaw on Operator.io

Box is a cloud content management and file sharing platform for businesses. It helps teams securely store, organize, and collaborate on files from anywhere.

Document & File Management284 actions

Get started

Automate Box with AI

Hand Box to an OpenClaw agent running on Operator. You write what you want in a chat and it turns that into real Box actions like add domain to list of allowed collaboration domains, add classification to file, add classification to folder, without you opening the app.

Your agent reaches Box directly or through connectors like Composio MCP and Pipedream MCP, which handle the sign in and token refresh for you, so there is nothing to wire up and no API keys to paste.

What your agent can do with Box

Your agent can call any of these Box actions by name as part of a larger task. Ask for the outcome you want and it picks the right ones.

Add domain to list of allowed collaboration domains

Creates a new entry in the list of allowed domains for collaboration within your enterprise. This allows you to whitelist specific domains for external collaboration. Use 'inbound' to allow users from the specified domain to collaborate...

Add classification to file

Adds a classification to a file by specifying the label of the classification to add. **Enterprise-only feature**: This action requires a Box enterprise account with classification templates configured. Users without an enterprise accoun...

Add classification to folder

Adds a classification to a folder by specifying the label of the classification to add. **Enterprise-only feature**: This action requires a Box enterprise account with classification templates configured. Users without an enterprise acco...

Add initial classifications

Initializes the classification template for an enterprise with an initial set of classification options. IMPORTANT: This action requires admin permissions and should only be called once per enterprise when no classifications exist. If cl...

Add or update user avatar

Adds or updates a user avatar.

Add shared link to file

Adds a shared link to a file.

Add shared link to folder

Adds a shared link to a folder, allowing it to be shared with others via a URL. This action creates or updates a shared link on a folder. The shared link can be configured with different access levels: - 'open': Anyone with the link can...

Add shared link to web link

Adds a shared link to a web link.

Add user to group

Creates a group membership. Only users with admin-level permissions will be able to use this API.

Append metadata taxonomy level

Appends a new level to a metadata taxonomy structure. Use when adding hierarchical categories to organize metadata. If no levels exist, this creates the first level.

Apply watermark to file

Applies or update a watermark on a file.

Apply watermark to folder

Applies or update a watermark on a folder.

Ask question

Ask questions about Box files using Box AI. Use this action to query one or more files with natural language questions. Box AI will analyze the file contents and provide an answer based on the information found in the files. Modes: - sin...

Assign legal hold policy

Assign a legal hold policy to a file, file version, folder, or user. Legal hold policies preserve content for litigation or compliance purposes by preventing the deletion of specified items. When assigned to a folder, the hold applies re...

Assign retention policy

Assigns a retention policy to an item in Box to enforce content retention. Use this action to apply a retention policy to: - An entire enterprise (assign_to_type='enterprise', no ID needed) - A specific folder (assign_to_type='folder', p...

Assign storage policy

Creates a storage policy assignment for an enterprise or user. Storage policies control where data is stored geographically (data residency). This action requires Box Zones or similar enterprise feature to be enabled. Use 'list_storage_p...

Assign task

Assigns a task to a user. A task can be assigned to more than one user by creating multiple assignments.

Authorize user

Authorize a user by sending them through the [Box](https://box.com) website and request their permission to act on their behalf. This is the first step when authenticating a user using OAuth 2.0. To request a user's authorization to use...

Cancel box sign request

Cancels a pending Box Sign request that has not yet been fully signed or declined. After cancellation, any outstanding signers will no longer be able to sign the document. Only the user who created the request (the requester) is able to...

Commit upload session

Commits an upload session and creates a file from the uploaded chunks. This is the final step in a chunked upload workflow: 1. Create an upload session using 'create_upload_session' 2. Upload file parts using 'upload_part_of_file' 3. Com...

Copy file

Creates a copy of a file.

Copy file request

Copies an existing file request to a new folder. File requests allow external users to upload files to a specific folder without needing a Box account. This action creates a copy of an existing file request and associates it with a diffe...

Copy folder

Creates a copy of a folder within a destination folder. The original folder will not be changed.

Create AI Agent

Creates a custom AI agent in Box AI Studio. At least one capability required: ask (Q&A), text_gen (content generation), or extract (metadata extraction). Requirements: Box Enterprise Advanced account, Box AI Studio enabled, "Manage AI" s...

Create Box Sign Request

Creates a Box Sign request to send documents for electronic signing. Prepares documents and sends signature requests to signers via email. Signers do not need Box accounts. Supports up to 10 files, 35 signers, sequential signing order, t...

Create box skill cards on file

Applies one or more Box Skills metadata cards to a file. NOTE: This action creates NEW Box Skill cards on a file. If Box Skill cards already exist on the file, this action will fail with a 409 Conflict error. In that case: - Use 'remove_...

Create user exemption from collaboration domain restrictions

Exempts a specific user from the enterprise's collaboration domain restrictions. This allows the specified user to collaborate with external parties from any domain, bypassing the enterprise's allowed collaboration domain list. PREREQUIS...

Create collaboration

Adds a collaboration for a single user or a single group to a file or folder. Collaborations can be created using email address, user IDs, or a group IDs. If a collaboration is being created with a group, access to this endpoint is depen...

Create comment

Adds a comment by the user to a specific file, or as a reply to an other comment.

Create email alias

Adds a new email alias to a user account. The email domain must be registered to your enterprise. Returns the newly created email alias object with id, type, email, and is_confirmed fields.

Create folder

Creates a new empty folder within the specified parent folder.

Create folder lock

Creates a folder lock on a folder, preventing it from being moved and/or deleted. You must be authenticated as the owner or co-owner of the folder to use this endpoint.

Create group

Creates a new group of users in an enterprise. Only users with admin permissions can create new groups.

Create legal hold policy

Create a new legal hold policy in Box. Legal hold policies are used to prevent permanent deletion of content during ongoing litigation. Once created, the policy can be assigned to specific users, folders, or files. IMPORTANT: Either `is_...

Create metadata cascade policy

Creates a new metadata cascade policy that automatically applies a metadata template to all files and subfolders within a specified folder. Prerequisites: - A metadata instance must already be applied to the target folder before creating...

Create metadata instance on file

Applies an instance of a metadata template to a file. The metadata_fields parameter contains key-value pairs that match the fields defined in the template. In most cases only field keys present in the metadata template will be accepted,...

Create metadata instance on folder

Applies an instance of a metadata template to a folder. In most cases only values that are present in the metadata template will be accepted, except for the `global.properties` template which accepts any key-value pair. To display the me...

Create metadata taxonomy

Tool to create a new metadata taxonomy in Box. Use when you need to set up a hierarchical classification system for organizing and categorizing metadata templates.

Create metadata taxonomy levels

Creates new hierarchical levels for a metadata taxonomy in Box. Use this to define the structure of your taxonomy by specifying levels like Continent -> Country -> City. Each level must have a unique level number starting from 1, with hi...

Create metadata taxonomy node

Tool to create a new metadata taxonomy node within a specified taxonomy. Use when you need to add a new classification or category to an existing metadata taxonomy hierarchy.

Create metadata template

Creates a new metadata template that can be applied to files and folders.

Create retention policy

Creates a retention policy for managing content lifecycle in Box. Retention policies prevent permanent deletion of content for a specified duration. Once created, policies can be assigned to folders or the entire enterprise. Note: This e...

Create shield information barrier

Creates a shield information barrier to establish an "ethical wall" that separates individuals/groups within an enterprise and prevents confidential information sharing. Prerequisites: Box Shield add-on must be licensed and enabled. Admi...

Create shield information barrier report

Creates a shield information barrier report for a given barrier. Shield information barrier reports track the configuration status of information barriers in Box Shield. When created, reports start with status 'pending' and transition to...

Create shield information barrier segment

Creates a new shield information barrier segment for compliance and information isolation. Segments represent organizational divisions (e.g., Investment Banking, Research, Trading) that need to be isolated from each other for regulatory...

Create shield information barrier segment member

Adds a Box user to a shield information barrier segment for compliance and information security. This assigns users to segments that restrict collaboration between departments (e.g., Investment Banking vs Research in financial institutio...

Create shield information barrier segment restriction

Creates a ONE-WAY shield information barrier segment restriction preventing collaboration between members of two segments (e.g., Investment Banking cannot collaborate with Research). Prerequisites: - Box Shield add-on enabled (returns 40...

Create slack integration mapping

Creates a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack) by mapping a Slack channel to a Box item. You need Admin or Co-Admin role to use this endpoint.

Plus 236 more Box actions your agent can call.

How to connect Box

You authorize Box once from your dashboard. Operator holds the connection and refreshes the access tokens on its own, so your agent keeps working with Box without you signing in again. The same setup unlocks every other app your agent can reach, so you only do it once.

When you are ready, the get started guide walks through standing up your OpenClaw agent.

Common questions about Box

How do I connect Box to Operator?: You authorize Box once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Box without you signing in again.
Can my agent work with my files in Box?: Yes. It can create, read, update, and organize documents and files, and pull one back when you ask. Use it to file new documents in the right place, search for something across your account, or keep Box tidy without doing it by hand.
Do I need to write code or manage Box API keys?: No code and no API keys. You authorize Box through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.
Can my agent use Box together with my other apps?: Yes. The same agent reaches every app you connect, so it can move between Box and tools like Google Drive, Google Docs, Dropbox in one job, reading from one and acting in another without you wiring anything between them.