> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Box Toolkit

> Search, read, upload, and manage Box files and folders via OAuth

The **Box** toolkit lets agents search and browse files and folders, read and download content, upload files and versions, create folders and Box Notes, move/copy/delete items, create shared links, and add collaborators. Authentication is **per-user OAuth**.

Add it on the agent **Toolkits** tab. The first use prompts the user to connect Box if they have not already.

## Prerequisites

* A Box account with access to the content the agent should use
* Box OAuth configured for your organization (admin)
* An agent you can edit
* Users must complete the Box OAuth connect flow when prompted

## Setup

1. Confirm an admin has configured Box OAuth (Client ID, Client Secret, redirect URI).
2. Open the agent → **Toolkits** → add **Box**.
3. Save the agent. In **Chat**, connect Box when prompted.
4. `@`-mention Box tools in the personality prompt for file tasks.

## Available tools

| Tool                    | Description                                |
| ----------------------- | ------------------------------------------ |
| **Search Files**        | Searches files the user can access.        |
| **List Folder Items**   | Lists items in a folder.                   |
| **Resolve Path**        | Resolves a folder/file path to an item.    |
| **Get File Info**       | Returns file metadata.                     |
| **Get Folder Info**     | Returns folder metadata.                   |
| **Read File Content**   | Reads file content when supported.         |
| **Download File**       | Downloads a file.                          |
| **Upload File**         | Uploads a new file.                        |
| **Upload File Version** | Uploads a new version of an existing file. |
| **Create Folder**       | Creates a folder.                          |
| **Create Box Note**     | Creates a Box Note.                        |
| **Move or Rename Item** | Moves or renames a file or folder.         |
| **Copy File**           | Copies a file.                             |
| **Delete Item**         | Deletes a file or folder.                  |
| **Create Shared Link**  | Creates a shared link.                     |
| **Add Collaboration**   | Adds a collaborator.                       |
| **Get Current User**    | Returns the connected Box user.            |

## Use cases

* Find and summarize a document stored in Box
* Upload a generated report into a project folder
* Share a file link with a collaborator from chat

## Tips

* Access is limited to what the **connected Box user** can see and edit.
* Prefer folder IDs from list/search results when paths are ambiguous.
* For Dropbox or Google Drive, use those toolkits instead.

## Troubleshooting

| Symptom                | What to check                                          |
| ---------------------- | ------------------------------------------------------ |
| OAuth / connect loop   | Complete Box OAuth; reconnect with the correct account |
| Empty search or folder | User lacks access; confirm folder ID                   |
| Upload or delete fails | Write permissions on the parent folder                 |

## Related

* [Dropbox](/agents/toolkits/dropbox)
* [Google Drive](/agents/toolkits/google-drive)
* [Amazon S3](/agents/toolkits/amazon-s3)
* [Toolkits overview](/agents/toolkits/overview)