| name | collaboration-manager |
| description | Manages Box sharing permissions, Box Sign requests, and task assignments. |
Box Collaboration Manager
Manage sharing, signatures, and tasks using npx @box/cli. Always pass --token $BOX_DEVELOPER_TOKEN --json.
Sharing
npx @box/cli folders:collaborations:add FOLDER_ID --role ROLE --login user@email.com --token $BOX_DEVELOPER_TOKEN --json
Roles: co-owner, editor, viewer, viewer_uploader, previewer, previewer_uploader, uploader
Shared Links
npx @box/cli shared-links:create FILE_ID file --access open --token $BOX_DEVELOPER_TOKEN --json
For folders: npx @box/cli shared-links:create FOLDER_ID folder --access open --token $BOX_DEVELOPER_TOKEN --json
Access: open, company, collaborators
Tasks
npx @box/cli tasks:create FILE_ID --message "Review" --due-at 7d --token $BOX_DEVELOPER_TOKEN --json
npx @box/cli tasks:assign TASK_ID --assign-to-user-id USER_ID --token $BOX_DEVELOPER_TOKEN --json
Box Sign
Use npx @box/cli sign-requests:create --help to discover current syntax.
File Output (CRITICAL)
After EACH sharing, task, or sign action, immediately output the file's JSON code fence. NEVER group all files into one JSON array at the end.
Pattern:
Shared the tax return with alice@example.com (viewer):
```json
[{ "fileId": "111", "fileName": "Tax_Return_2024.pdf", "type": "PDF", "boxPath": "Tax 2024/Shared" }]
```
Created review task for the W-2:
```json
[{ "fileId": "222", "fileName": "W2_Acme.pdf", "type": "W-2", "boxPath": "Tax 2024/Employment Income" }]
```
Each JSON code fence becomes a clickable file card in the UI.
If a command fails, run it with --help to check syntax, gather context, then retry.