# Box

> Let your assistants search and read the files and folders in your Box account. Read only, through Box's own hosted connector. Coming soon.

Status: Coming soon

Box is a place many companies keep contracts, reports, and shared documents. Once you connect it, your assistants can search your files and read them, so an answer starts from the real document.

> [!SOON]
> The Box integration is Coming soon. This page describes how it will work. The integrations open at launch are GitHub, GitLab, and Bitbucket.

## Which assistants use it

| Assistant | Status |
| --- | --- |
| [Legal](/docs/personas/legal) | Coming soon |
| [Accountant](/docs/personas/accountant) | Coming soon |

Neither of these personas is open yet. The Coder is the only persona available today, and it does not list Box.

## What assistants can do

Box connects through the tool's own hosted connector, and it is read only.

| Ability | How it runs |
| --- | --- |
| Search files and folders | Reads on its own |
| Read file contents | Reads on its own |
| Upload, move, or change a file | Never run from chat |

## Setup (when it opens)

1. In Box, open the developer console and create an app.
2. Generate an access token for the account the assistants should use. Pick an account that can see only the folders you want to share.
3. Open [Integrations](https://stellarfirm.ai/app/integrations) in StellarFirm.
4. Pick Box.
5. Paste the token, switch on the live option, and press Connect.

## Permissions

- The assistants can read whatever the chosen Box account can read, and nothing else.
- Nothing here waits for an Approve because nothing here changes data. Uploads and edits are never run from chat.
- Revoke the token in Box whenever you want to cut access.

## Good to know

- A dedicated Box account with access to a few folders is safer than your own account.
- Name the file or the folder in your message. Searches work best on a distinctive title.
- Files can be long. Ask for what you need, such as a clause checklist or a list of dates, instead of "summarise everything".
- Sibling tools: [Dropbox](/docs/integrations/dropbox) and [Egnyte](/docs/integrations/egnyte) work the same way.

## Prompts to try

```prompt title="Review a contract"
Legal, find the latest signed vendor agreement for [vendor] in Box and give me a clause checklist. Read only.
```

```prompt title="Find a statement"
Accountant, find the bank statements for [month] in Box and list the totals by account.
```

```prompt title="Locate a file"
Search Box for [document name] and tell me which folder it is in and when it was last changed.
```

---

Source: https://stellarfirm.ai/docs/integrations/box