Box Integration

Use Box integration to let Dawn discover folders, browse their contents, read files, and search within the boundaries you link.

Box can be connected two ways. A workspace owner or manager can connect it as a shared source from the workspace Integrations screen and assign the linked folders to specific agents. An individual user can also connect their own Box account as a personal connection under account settings → My connections, where it stays scoped to that user. Use the workspace path for folders the whole team should reach, and the personal path for your own files.

Before you start

  • A Box account with access to the folders Dawn should use.
  • For a workspace connection, the Manager role, which is required to create it.
  • For a team agent, prefer a shared or service Box account rather than a personal login, because the connection acts as the workspace’s view into Box.

Box connects through Box sign-in with read-only access. A manual access token is also accepted in the credential field, which is mainly useful for testing because developer tokens are short-lived.

Connecting Box

  • Shared workspace source: open the workspace Integrations screen, add a Box connection, and click Connect Box to complete Box sign-in. Then choose what to link and assign the linked sources to the agents that should use them.
  • Personal connection: open account settings → My connections, add Box, and complete Box sign-in.

Dawn discovers All files/folders plus the top-level folders visible to the connected account. Each selection becomes one source in Dawn.

Linking All files/folders gives assigned agents access to everything the connected account can see, so the option is called out separately during setup. For a narrower boundary, link only the specific root folders agents should use. Agents stay inside the linked folder: every browse, read, and search is scoped to it.

What agents can do

Agents with an assigned Box source can browse folder trees, read text files, and open binary files such as PDFs, Office documents, images, and archives through Dawn’s document tools. They can also search files under the linked folder using Box Search, so coverage depends on Box’s own indexing and supported file types.

The integration is read-only. Agents cannot create, update, move, delete, or share Box files, and Dawn does not create shared links. Box Notes are not supported. Dawn reads files at request time and does not sync or store their contents.

Connected as a personal connection, Box provides the same read-only browse, search, and read capabilities, scoped to the user who connected it and available in their conversations and explicitly delegated runs.

Troubleshooting

  • Sign-in fails or is cancelled: start the connection again and approve the Box permissions Dawn requests.
  • Invalid token: a manual access token is expired, revoked, or copied incorrectly. Reconnect with Box sign-in or paste a fresh token.
  • No folders appear: link All files/folders if the account has no top-level folders, or confirm the signed-in Box account can see the expected folders.
  • Search misses a recent file: Box indexes content on its side, so very recent files can lag and some file types are not indexed. Browsing the folder directly is the reliable fallback.
  • A very large file fails to open: Dawn enforces file size limits when reading provider files.