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

# Box

> Connect Box to your Atako agents — 8 read and 7 write actions.

Let your agents browse, search, organize, share and comment on the files in your Box account.

## Connection

* **Authentication**: OAuth 2.0 — you authorize Atako via Box's consent screen; no key to copy.

<Note>
  Nothing to paste: click Connect and approve Atako in your Box account. Prerequisite on the Atako side — an administrator creates a Box app (Developer Console [https://app.box.com/developers/console](https://app.box.com/developers/console) → Create Platform App → Custom App → User Authentication (OAuth 2.0)), adds the Redirect URI \$\{API\_URL}/integrations/oauth/callback in Configuration, ticks the Application Scopes "Read all files and folders stored in Box" and "Write all files and folders stored in Box", and puts its Client ID and Client Secret in INTEGRATION\_OAUTH\_BOX\_CLIENT\_ID / \_CLIENT\_SECRET.

  See [Box's documentation](https://developer.box.com/guides/authentication/oauth2/).
</Note>

## Read actions (8)

| Action                | Description                                                                                                                                                                                             |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_current_user`    | Fetch the connected Box user (id, name, login, storage usage).                                                                                                                                          |
| `get_file`            | Fetch a file's metadata (name, size, parent, owner, versions). Pass fields \["shared\_link"] to read its shared link.                                                                                   |
| `get_folder`          | Fetch a folder's details and first items. folder\_id "0" is the root ("All Files").                                                                                                                     |
| `list_collaborations` | List who has access to a file or folder (collaborators, roles, status). Paginate with the returned marker.                                                                                              |
| `list_file_comments`  | List the comments on a file.                                                                                                                                                                            |
| `list_folder_items`   | List the files, folders and web links in a folder (folder\_id "0" = root). Paginate with offset + limit (max 1000).                                                                                     |
| `list_recent_items`   | List the items the user recently opened, previewed or edited. Paginate with the returned marker.                                                                                                        |
| `search`              | Search files, folders and web links by name, description, content, comments or tags. Filter by type, file\_extensions (without dots) and ancestor\_folder\_ids; paginate with offset + limit (max 200). |

## Write actions (7)

| Action               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `add_collaboration`  | Give a user or group access to a file or folder. Arguments: item (object, required): type (string "file" or "folder"), id (string); accessible\_by (object, required): type (string "user" or "group"), plus login (string, user e-mail) or id (string, user or group ID); role (string, required: editor, viewer, previewer, uploader, "previewer uploader", "viewer uploader", co-owner); notify (boolean, optional — e-mail the collaborator). |
| `add_comment`        | Comment on a file, or reply to a comment. Arguments: item (object, required): type (string "file" or "comment"), id (string); message (string, required — plain text).                                                                                                                                                                                                                                                                            |
| `copy_file`          | Copy a file into a folder. Arguments: file\_id (string, required); parent (object \{ id: string }, required — destination folder); name (string, optional — new name for the copy).                                                                                                                                                                                                                                                               |
| `create_folder`      | Create a folder. Arguments: name (string, required); parent (object \{ id: string }, required — "0" = root). Example: \{ "name": "Contrats", "parent": \{ "id": "0" } }.                                                                                                                                                                                                                                                                          |
| `create_shared_link` | Create or replace the shared link of a file or folder and return it. Arguments: item\_type (string "file" or "folder", required); item\_id (string, required); shared\_link (object, required): access (string "open" = anyone with the link, "company", or "collaborators"; omitted = enterprise default), permissions (object \{ can\_download: boolean }, optional), unshared\_at (string, ISO 8601 expiry date, optional).                    |
| `move_item`          | Move a file or folder into another folder. Arguments: item\_type (string "file" or "folder", required); item\_id (string, required); parent (object \{ id: string }, required — destination folder, "0" = root).                                                                                                                                                                                                                                  |
| `rename_item`        | Rename a file or folder. Arguments: item\_type (string "file" or "folder", required); item\_id (string, required); name (string, required — new name, keep the extension for a file).                                                                                                                                                                                                                                                             |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.