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

# Box

> Connect Box to your workflows: 29 operations across 10 categories.

The Box node adds Box operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields.

Box also includes 1 trigger operation (marked in the tables below) that can start a workflow when something happens in Box.

<Note>
  You can wire the Box node into an AI agent as a tool provider: the agent calls the operations you allow. See [Agent tools](/agents/tools).
</Note>

## Credentials

Connect Box under **Credentials** in the node settings. See [Connecting credentials](/credentials/connecting) for the general flow.

### OAuth

Sign in with your Box account when prompted; no keys to copy.

[Get your credentials here](https://app.box.com/developers/console).

NoClick requests the following permissions:

* `root_readwrite`
* `manage_managed_users`
* `manage_groups`
* `manage_webhook`
* `manage_enterprise_properties`

### Developer token

Enter the values manually when creating the credential.

[Get your credentials here](https://app.box.com/developers/console).

## Operations

### Collaboration

| Operation                | ID                     | Description                                         | Trigger |
| ------------------------ | ---------------------- | --------------------------------------------------- | ------- |
| **Add Collaboration**    | `add_collaboration`    | Share a file or folder with a user at a given role. |         |
| **List Collaborations**  | `list_collaborations`  | List collaborators on a folder or file.             |         |
| **Remove Collaboration** | `remove_collaboration` | Remove a collaborator.                              |         |

### Comments

| Operation              | ID              | Description              | Trigger |
| ---------------------- | --------------- | ------------------------ | ------- |
| **Add Comment**        | `add_comment`   | Add a comment to a file. |         |
| **List File Comments** | `list_comments` | List comments on a file. |         |

### Files

| Operation                 | ID                 | Description                                                        | Trigger |
| ------------------------- | ------------------ | ------------------------------------------------------------------ | ------- |
| **Copy File**             | `copy_file`        | Copy a file into a destination folder.                             |         |
| **Delete File**           | `delete_file`      | Move a file to the trash.                                          |         |
| **Get File Download URL** | `get_download_url` | Get a download URL for a file (follows Box's 302 redirect).        |         |
| **Get File Info**         | `get_file`         | Retrieve file metadata.                                            |         |
| **Update File**           | `update_file`      | Rename, move, or change a file's description.                      |         |
| **Upload File**           | `upload_file`      | Upload a new file from inline text content into a folder.          |         |
| **Upload New Version**    | `upload_version`   | Upload a new version of an existing file from inline text content. |         |

### Folders

| Operation              | ID                  | Description                                                 | Trigger |
| ---------------------- | ------------------- | ----------------------------------------------------------- | ------- |
| **Copy Folder**        | `copy_folder`       | Copy a folder (and its contents) into a destination parent. |         |
| **Create Folder**      | `create_folder`     | Create a new folder under a parent.                         |         |
| **Delete Folder**      | `delete_folder`     | Delete a folder (moves it to the trash).                    |         |
| **Get Folder Info**    | `get_folder`        | Retrieve metadata for a folder.                             |         |
| **List Folder Items**  | `list_folder_items` | List files, folders, and web links inside a folder.         |         |
| **List Trashed Items** | `list_trash`        | List items currently in the trash.                          |         |
| **Update Folder**      | `update_folder`     | Rename, move, or change folder properties.                  |         |

### Search

| Operation          | ID       | Description                                    | Trigger |
| ------------------ | -------- | ---------------------------------------------- | ------- |
| **Search Content** | `search` | Search files, folders, and web links by query. |         |

### Sharing

| Operation                     | ID                          | Description                                      | Trigger |
| ----------------------------- | --------------------------- | ------------------------------------------------ | ------- |
| **Create File Shared Link**   | `create_file_shared_link`   | Create or update a public shared link on a file. |         |
| **Create Folder Shared Link** | `create_folder_shared_link` | Create or update a shared link on a folder.      |         |

### Tasks

| Operation       | ID            | Description                                 | Trigger |
| --------------- | ------------- | ------------------------------------------- | ------- |
| **Create Task** | `create_task` | Create a review or approval task on a file. |         |

### Users

| Operation                 | ID           | Description                                                 | Trigger |
| ------------------------- | ------------ | ----------------------------------------------------------- | ------- |
| **Get Current User**      | `get_me`     | Retrieve the authenticated user's profile.                  |         |
| **List Enterprise Users** | `list_users` | List managed users in the enterprise (admin / server auth). |         |

### Webhooks

| Operation          | ID               | Description                                                       | Trigger |
| ------------------ | ---------------- | ----------------------------------------------------------------- | ------- |
| **Create Webhook** | `create_webhook` | Register a webhook on a file or folder (manual, not the trigger). |         |
| **Delete Webhook** | `delete_webhook` | Delete a webhook.                                                 |         |
| **List Webhooks**  | `list_webhooks`  | List all webhooks created by the app for the user.                |         |

### Other

| Operation                   | ID             | Description                                                                  | Trigger |
| --------------------------- | -------------- | ---------------------------------------------------------------------------- | ------- |
| **On File or Folder Event** | `on_box_event` | Fire the workflow when a Box file/folder event occurs (FILE.UPLOADED, etc.). | Yes     |
