---
title: "Box integration for LuumenAI"
url: "https://www.luumen.ai/integrations/box/"
entity: SoftwareIntegration
category: "Productivity & files"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Box integration for LuumenAI

Read, classify, and share Box content from the terminal, with writes held for approval

## What LuumenAI can do with Box

LuumenAI connects to Box with OAuth 2.0 and exposes 284 tools (131 read-only · 102 write · 51 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: OAuth 2.0
- Tools available: 284 tools (131 read-only · 102 write · 51 destructive)
- Plan: available on all plans
- Category: Productivity & files

## About Box with LuumenAI

Connect Box and Luumen can search your content, read file contents, resolve shared links, and pull metadata out of documents with Box AI. When something needs to change — a classification label, a new shared link, an allowed collaboration domain — Luumen shows the plan first and waits for your approval by default. Authentication is OAuth2.

## Example tools

Read-only (131 in total):

- `BOX_ASK_QUESTION` — Ask questions about Box files using Box AI.
- `BOX_AUTHORIZE_USER` — Authorize a user by sending them through the [Box](https://box.com) website and request their permission to act on their behalf.
- `BOX_DOWNLOAD_FILE` — Returns the contents of a file in binary format.
- `BOX_DOWNLOAD_ZIP_ARCHIVE` — Downloads a zip archive containing files and/or folders from Box.
- `BOX_EXTRACT_METADATA_FREEFORM` — Extract metadata from Box files using AI with freeform prompts.
- `BOX_EXTRACT_METADATA_STRUCTURED` — Extract structured metadata from files using Box AI.
- `BOX_FIND_APP_ITEM_FOR_SHARED_LINK` — Returns the file, folder, web link, or app item represented by a shared link.
- `BOX_FIND_FILE_FOR_SHARED_LINK` — Returns the file represented by a shared link.

Write and destructive (153 in total, approval required by default):

- `BOX_ADD_ALLOWED_COLLABORATION_DOMAIN` — Creates a new entry in the list of allowed domains for collaboration within your enterprise.
- `BOX_ADD_CLASSIFICATION_TO_FILE` — Adds a classification to a file by specifying the label of the classification to add.
- `BOX_ADD_CLASSIFICATION_TO_FOLDER` — Adds a classification to a folder by specifying the label of the classification to add.
- `BOX_ADD_INITIAL_CLASSIFICATIONS` — Initializes the classification template for an enterprise with an initial set of classification options.
- `BOX_ADD_OR_UPDATE_USER_AVATAR` — Adds or updates a user avatar.
- `BOX_ADD_SHARED_LINK_TO_FILE` — Adds a shared link to a file.
- `BOX_ADD_SHARED_LINK_TO_FOLDER` — Adds a shared link to a folder, allowing it to be shared with others via a URL.
- `BOX_ADD_SHARED_LINK_TO_WEB_LINK` — Adds a shared link to a web link.

## Frequently asked questions

### How does LuumenAI connect to Box?

Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Box on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 51 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Box — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/box/