collaboration-manager

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 [e-mail] --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 [e-mail] (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.