# Box AI integration on Definable

> Box is a cloud content management platform for secure file storage, sharing, collaboration, and governance.

## What this connects

Box is a cloud content management platform for secure file storage, sharing, collaboration, and governance.

Vendor: https://www.box.com

## Tools available

**284** tools available. First 12:

- `BOX_ADD_ALLOWED_COLLABORATION_DOMAIN` — 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 on your enterprise's files and folders. Use 'outbound' to allow your enterprise users to collaborate on content owned by the specified domain. Use 'both' for bidirectional collaboration. Note: This action requires enterprise admin privileges and the 'manage_enterprise_properties' scope.
- `BOX_ADD_CLASSIFICATION_TO_FILE` — 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 account will receive an error when attempting to use this feature. This API can also be called by including the enterprise ID in the URL explicitly, for example `/files/:id//enterprise_12345/securityClassification-6VMVochwUWo`.
- `BOX_ADD_CLASSIFICATION_TO_FOLDER` — 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 account will receive an error when attempting to use this feature. **Prerequisites**: - A classification template must exist in the enterprise. Use `list_all_classifications` to retrieve available classification keys. - If no classifications exist, an admin must first create the classification template using `add_initial_classifications`. **Common errors**: - 404: Classification template not found (no classifications exist in enterprise) - 409: Classification already exists on this folder (use update action instead) - 403: Insufficient permissions to add classifications This API can also be called by including the enterprise ID in the URL explicitly, for example `/folders/:id//enterprise_12345/securityClassification-6VMVochwUWo`.
- `BOX_ADD_INITIAL_CLASSIFICATIONS` — 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 classifications already exist, use the 'add_classification' action to add more options. Common classification examples: 'Confidential', 'Internal', 'Public', 'Restricted'. Returns 400 if the classification template already exists. Returns 403 if the user lacks admin permissions.
- `BOX_ADD_OR_UPDATE_USER_AVATAR` — Add or update user avatar — Adds or updates a user avatar.
- `BOX_ADD_SHARED_LINK_TO_FILE` — Add shared link to file — Adds a shared link to a file.
- `BOX_ADD_SHARED_LINK_TO_FOLDER` — 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 access - 'company': Only people within the company can access (paid accounts only) - 'collaborators': Only those invited to the folder can access To create a shared link with default enterprise settings, call with just folder_id and fields='shared_link'. To customize access, set shared_link_access parameter. Returns the folder object with the new shared_link information including the URL.
- `BOX_ADD_SHARED_LINK_TO_WEB_LINK` — Add shared link to web link — Adds a shared link to a web link.
- `BOX_ADD_USER_TO_GROUP` — Add user to group — Creates a group membership. Only users with admin-level permissions will be able to use this API.
- `BOX_APPEND_METADATA_TAXONOMY_LEVEL` — 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.
- `BOX_APPLY_WATERMARK_TO_FILE` — Apply watermark to file — Applies or update a watermark on a file.
- `BOX_APPLY_WATERMARK_TO_FOLDER` — Apply watermark to folder — Applies or update a watermark on a folder.

## Auth

Auth schemes: `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Box

Inside a Definable workflow, Box is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Box** — the Researcher (GPT-5.5) pulls context from Box (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Box** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Box (create record, post message, draft email).
- **Designer / Engineer → Distributor → Box** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Box (attach file, open PR comment, post status).

The Verifier checks every Box call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- file management & storage — https://definable.ai/apps/category/file-management-&-storage/
- documents — https://definable.ai/apps/category/documents/

## Related

- HTML page: https://definable.ai/apps/box/
- Same category (file management & storage): https://definable.ai/apps/category/file-management-&-storage/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt