# Box

Manage Box files and folders: upload, download, search, collaborations, comments. Exposes **37 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `box_file_get` | Get file info - GET /files/{id}. |
| `box_file_list_versions` | List file versions - GET /files/{id}/versions. |
| `box_file_download` | Download file content - GET /files/{id}/content. |
| `box_file_copy` | Copy a file - POST /files/{id}/copy. |
| `box_file_move` | Move a file to another folder - PUT /files/{id}. |
| `box_file_delete` | Delete a file - DELETE /files/{id}. |
| `box_file_update` | Update file metadata - PUT /files/{id}. |
| `box_folder_get` | Get folder info - GET /folders/{id}. |
| `box_folder_list_items` | List folder contents - GET /folders/{id}/items. |
| `box_folder_create` | Create a new folder - POST /folders. |
| `box_folder_delete` | Delete a folder - DELETE /folders/{id}. |
| `box_folder_update` | Update folder metadata - PUT /folders/{id}. |
| `box_search` | Search for files and folders - GET /search. |
| `box_shared_link_create` | Create a shared link for a file or folder - PUT /files\|folders/{id}. |
| `box_shared_link_list` | Get shared link info - GET /files\|folders/{id}?fields=shared_link. |
| `box_shared_link_delete` | Delete/remove a shared link - PUT /files\|folders/{id}. |
| `box_shared_link_update` | Update a shared link - PUT /files\|folders/{id}. |
| `box_collaboration_add` | Add a collaborator to a file or folder - POST /collaborations. |
| `box_collaborations_list` | List collaborations on a file or folder - GET /files\|folders/{id}/collaborations. |
| `box_collaboration_get` | Get collaboration details - GET /collaborations/{id}. |
| `box_collaboration_update` | Update a collaboration role - PUT /collaborations/{id}. |
| `box_collaboration_delete` | Remove a collaborator - DELETE /collaborations/{id}. |
| `box_comment_create` | Add a comment to a file - POST /comments. |
| `box_comments_list` | List comments on a file - GET /files/{id}/comments. |
| `box_comment_get` | Get comment details - GET /comments/{id}. |
| `box_comment_update` | Update a comment - PUT /comments/{id}. |
| `box_comment_delete` | Delete a comment - DELETE /comments/{id}. |
| `box_user_get` | Get user info - GET /users/{id}. |
| `box_users_list` | List enterprise users - GET /users. |
| `box_user_get_me` | Get current authenticated user - GET /users/me. |
| `box_user_create` | Create a new user - POST /users. |
| `box_user_update` | Update a user - PUT /users/{id}. |
| `box_user_delete` | Delete a user - DELETE /users/{id}. |
| `box_metadata_get` | Get metadata for a file or folder - GET /files\|folders/{id}/metadata/{scope}/{template}. |
| `box_metadata_list` | List metadata on a file or folder - GET /files\|folders/{id}/metadata. |
| `box_metadata_set` | Set metadata on a file or folder - POST /files\|folders/{id}/metadata/{scope}/{template}. |
| `box_metadata_update` | Update metadata on a file or folder - PATCH /files\|folders/{id}/metadata/{scope}/{template}. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Box to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Box API documentation](https://developer.box.com/reference/)