> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Box
> Enterprise file storage and content management API for reading, writing, searching, and sharing files and folders in a user's Box account.
Enterprise file storage and content management API for reading, writing, searching, and sharing files and folders in a user's Box account. Best for workflows that need to persist documents, pull file content into downstream tools, or automate collaboration invites. Unlike Google Drive, Box is tuned for regulated enterprise content with granular collaboration roles and compliance-grade audit trails.
10 example endpoints available through Lava's AI Gateway. See the [Box API docs](https://developer.box.com/reference/) for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
This is a **catch-all provider** — any valid URL under `https://api.box.com` is supported. Any Box REST API endpoint under [https://api.box.com/2.0/](https://api.box.com/2.0/). Common resources: /2.0/users/me, /2.0/folders/\{id} and /2.0/folders/\{id}/items, /2.0/files/\{id}, /2.0/search, /2.0/collaborations. File uploads use a separate host ([https://upload.box.com/api/2.0/files/content](https://upload.box.com/api/2.0/files/content)) and are not currently proxied via the api.box.com catch-all — use download + metadata endpoints for the common agent workflows. Pagination is offset-based (offset, limit query params) with marker-based pagination available on large collections (marker + usemarker=true). Rate limit: 1000 requests/minute per user. See [https://developer.box.com/reference/](https://developer.box.com/reference/) for the full API reference. The endpoints below are curated examples.
## Endpoints
### Return the profile of the currently authenticated Box user.
**GET** `https://api.box.com/2.0/users/me` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/users/me', { method: 'GET' });
```
```bash theme={null}
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Fusers%2Fme" \
-H "Authorization: Bearer $LAVA_SECRET_KEY"
```
### List items inside a folder. Use folder id "0" for the root folder. Supports offset/limit pagination and fields param for sparse fieldsets.
**GET** `https://api.box.com/2.0/folders/0/items?offset=0&limit=100` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/folders/0/items?offset=0&limit=100', { method: 'GET' });
```
```bash theme={null}
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffolders%2F0%2Fitems%3Foffset%3D0%26limit%3D100" \
-H "Authorization: Bearer $LAVA_SECRET_KEY"
```
### Retrieve metadata for a folder.
**GET** `https://api.box.com/2.0/folders/{folder_id}` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/folders/{folder_id}', { method: 'GET' });
```
```bash theme={null}
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffolders%2F%7Bfolder_id%7D" \
-H "Authorization: Bearer $LAVA_SECRET_KEY"
```
### Create a new folder under a specified parent folder.
**POST** `https://api.box.com/2.0/folders` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/folders', { body: {"name":"New Folder","parent":{"id":"0"}} });
```
```bash theme={null}
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffolders" \
-H "Authorization: Bearer $LAVA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"New Folder","parent":{"id":"0"}}'
```
### Retrieve metadata for a file (size, owner, created\_at, shared\_link, etc.).
**GET** `https://api.box.com/2.0/files/{file_id}` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/files/{file_id}', { method: 'GET' });
```
```bash theme={null}
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffiles%2F%7Bfile_id%7D" \
-H "Authorization: Bearer $LAVA_SECRET_KEY"
```
### Download file content. Returns 302 redirect to a signed CDN URL with the file body.
**GET** `https://api.box.com/2.0/files/{file_id}/content` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/files/{file_id}/content', { method: 'GET' });
```
```bash theme={null}
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffiles%2F%7Bfile_id%7D%2Fcontent" \
-H "Authorization: Bearer $LAVA_SECRET_KEY"
```
### Move a file to trash (soft delete).
**DELETE** `https://api.box.com/2.0/files/{file_id}` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/files/{file_id}', { method: 'DELETE' });
```
```bash theme={null}
curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffiles%2F%7Bfile_id%7D" \
-H "Authorization: Bearer $LAVA_SECRET_KEY" \
-H "Content-Type: application/json"
```
### Copy a file to a different folder.
**POST** `https://api.box.com/2.0/files/{file_id}/copy` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/files/{file_id}/copy', { body: {"parent":{"id":"0"}} });
```
```bash theme={null}
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Ffiles%2F%7Bfile_id%7D%2Fcopy" \
-H "Authorization: Bearer $LAVA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"parent":{"id":"0"}}'
```
### Search files, folders, and web links. Use query param for the search term, type to filter by kind, and offset/limit for pagination.
**GET** `https://api.box.com/2.0/search?query=quarterly+report` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/search?query=quarterly+report', { method: 'GET' });
```
```bash theme={null}
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Fsearch%3Fquery%3Dquarterly%2Breport" \
-H "Authorization: Bearer $LAVA_SECRET_KEY"
```
### Invite a user (by email or Box user id) to collaborate on a file or folder with a specified role.
**POST** `https://api.box.com/2.0/collaborations` — Free
```typescript theme={null}
const data = await lava.gateway('https://api.box.com/2.0/collaborations', {
body: {
"item": {
"type": "folder",
"id": "0"
},
"accessible_by": {
"type": "user",
"login": "collaborator@example.com"
},
"role": "editor"
},
});
```
```bash theme={null}
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.box.com%2F2.0%2Fcollaborations" \
-H "Authorization: Bearer $LAVA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"item":{"type":"folder","id":"0"},"accessible_by":{"type":"user","login":"collaborator@example.com"},"role":"editor"}'
```
## Next Steps
Browse all supported AI providers
Learn how to construct proxy URLs and authenticate requests