[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6EXVKXFFHZ4FC4ETNETP1T2":3,"skill-same:01M6EXVKXFFHZ4FC4ETNETP1T2":81},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":57,"ownerHtmlUrl":58,"ownerBlogUrl":6,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M6EXVKXFFHZ4FC4ETNETP1T2","box-automation",null,"Automate Box cloud storage operations including file upload\u002Fdownload, search, folder management, sharing, collaborations, and metadata queries via Rube MCP (Composio). Always search tools first for current schemas.","ComeOnOliver\u002Fskillshub","ComeOnOliver","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F43215937?v=4","01M6E5JNFECJAAVFE0W7SMWWD2","Haoran Shu","01M6E5JNNDQS7AJZDYFQ8TPZCK",66,"MIT","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Faiskillstore\u002Fmarketplace\u002Fsickn33\u002Fbox-automation\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"automation","box automation","box","via","MCP","upload","composio","queries","operations","management","automate","download","first","Tools","sharing","cloud","file","metadata","search","storage","2026-11-10 10:12:30",false,"---\nname: box-automation\ndescription: \"Automate Box cloud storage operations including file upload\u002Fdownload, search, folder management, sharing, collaborations, and metadata queries via Rube MCP (Composio). Always search tools first for current schemas.\"\nrequires:\n  mcp: [rube]\n---\n\n# Box Automation via Rube MCP\n\nAutomate Box operations including file upload\u002Fdownload, content search, folder management, collaboration, metadata queries, and sign requests through Composio's Box toolkit.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Box connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `box`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https:\u002F\u002Frube.app\u002Fmcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `box`\n3. If connection is not ACTIVE, follow the returned auth link to complete Box OAuth\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Upload and Download Files\n\n**When to use**: User wants to upload files to Box or download files from it\n\n**Tool sequence**:\n1. `BOX_SEARCH_FOR_CONTENT` - Find the target folder if path is unknown [Prerequisite]\n2. `BOX_GET_FOLDER_INFORMATION` - Verify folder exists and get folder_id [Prerequisite]\n3. `BOX_LIST_ITEMS_IN_FOLDER` - Browse folder contents and discover file IDs [Optional]\n4. `BOX_UPLOAD_FILE` - Upload a file to a specific folder [Required for upload]\n5. `BOX_DOWNLOAD_FILE` - Download a file by file_id [Required for download]\n6. `BOX_CREATE_ZIP_DOWNLOAD` - Bundle multiple files\u002Ffolders into a zip [Optional]\n\n**Key parameters**:\n- `parent_id`: Folder ID for upload destination (use `\"0\"` for root folder)\n- `file`: FileUploadable object with `s3key`, `mimetype`, and `name` for uploads\n- `file_id`: Unique file identifier for downloads\n- `version`: Optional file version ID for downloading specific versions\n- `fields`: Comma-separated list of attributes to return\n\n**Pitfalls**:\n- Uploading to a folder with existing filenames can trigger conflict behavior; decide overwrite vs rename semantics\n- Files over 50MB should use chunk upload APIs (not available via standard tools)\n- The `attributes` part of upload must come before the `file` part or you get HTTP 400 with `metadata_after_file_contents`\n- File IDs and folder IDs are numeric strings extractable from Box web app URLs (e.g., `https:\u002F\u002F*.app.box.com\u002Ffiles\u002F123` gives file_id `\"123\"`)\n\n### 2. Search and Browse Content\n\n**When to use**: User wants to find files, folders, or web links by name, content, or metadata\n\n**Tool sequence**:\n1. `BOX_SEARCH_FOR_CONTENT` - Full-text search across files, folders, and web links [Required]\n2. `BOX_LIST_ITEMS_IN_FOLDER` - Browse contents of a specific folder [Optional]\n3. `BOX_GET_FILE_INFORMATION` - Get detailed metadata for a specific file [Optional]\n4. `BOX_GET_FOLDER_INFORMATION` - Get detailed metadata for a specific folder [Optional]\n5. `BOX_QUERY_FILES_FOLDERS_BY_METADATA` - Search by metadata template values [Optional]\n6. `BOX_LIST_RECENTLY_ACCESSED_ITEMS` - List recently accessed items [Optional]\n\n**Key parameters**:\n- `query`: Search string supporting operators (`\"\"` exact match, `AND`, `OR`, `NOT` - uppercase only)\n- `type`: Filter by `\"file\"`, `\"folder\"`, or `\"web_link\"`\n- `ancestor_folder_ids`: Limit search to specific folders (comma-separated IDs)\n- `file_extensions`: Filter by file type (comma-separated, no dots)\n- `content_types`: Search in `\"name\"`, `\"description\"`, `\"file_content\"`, `\"comments\"`, `\"tags\"`\n- `created_at_range` \u002F `updated_at_range`: Date filters as comma-separated RFC3339 timestamps\n- `limit`: Results per page (default 30)\n- `offset`: Pagination offset (max 10000)\n- `folder_id`: For `LIST_ITEMS_IN_FOLDER` (use `\"0\"` for root)\n\n**Pitfalls**:\n- Queries with offset > 10000 are rejected with HTTP 400\n- `BOX_SEARCH_FOR_CONTENT` requires either `query` or `mdfilters` parameter\n- Misconfigured filters can silently omit expected items; validate with small test queries first\n- Boolean operators (`AND`, `OR`, `NOT`) must be uppercase\n- `BOX_LIST_ITEMS_IN_FOLDER` requires pagination via `marker` or `offset`\u002F`usemarker`; partial listings are common\n- Standard folders sort items by type first (folders before files before web links)\n\n### 3. Manage Folders\n\n**When to use**: User wants to create, update, move, copy, or delete folders\n\n**Tool sequence**:\n1. `BOX_GET_FOLDER_INFORMATION` - Verify folder exists and check permissions [Prerequisite]\n2. `BOX_CREATE_FOLDER` - Create a new folder [Required for create]\n3. `BOX_UPDATE_FOLDER` - Rename, move, or update folder settings [Required for update]\n4. `BOX_COPY_FOLDER` - Copy a folder to a new location [Optional]\n5. `BOX_DELETE_FOLDER` - Move folder to trash [Required for delete]\n6. `BOX_PERMANENTLY_REMOVE_FOLDER` - Permanently delete a trashed folder [Optional]\n\n**Key parameters**:\n- `name`: Folder name (no `\u002F`, `\\`, trailing spaces, or `.`\u002F`..`)\n- `parent__id`: Parent folder ID (use `\"0\"` for root)\n- `folder_id`: Target folder ID for operations\n- `parent.id`: Destination folder ID for moves via `BOX_UPDATE_FOLDER`\n- `recursive`: Set `true` to delete non-empty folders\n- `shared_link`: Object with `access`, `password`, `permissions` for creating shared links on folders\n- `description`, `tags`: Optional metadata fields\n\n**Pitfalls**:\n- `BOX_DELETE_FOLDER` moves to trash by default; use `BOX_PERMANENTLY_REMOVE_FOLDER` for permanent deletion\n- Non-empty folders require `recursive: true` for deletion\n- Root folder (ID `\"0\"`) cannot be copied or deleted\n- Folder names cannot contain `\u002F`, `\\`, non-printable ASCII, or trailing spaces\n- Moving folders requires setting `parent.id` via `BOX_UPDATE_FOLDER`\n\n### 4. Share Files and Manage Collaborations\n\n**When to use**: User wants to share files, manage access, or handle collaborations\n\n**Tool sequence**:\n1. `BOX_GET_FILE_INFORMATION` - Get file details and current sharing status [Prerequisite]\n2. `BOX_LIST_FILE_COLLABORATIONS` - List who has access to a file [Required]\n3. `BOX_UPDATE_COLLABORATION` - Change access level or accept\u002Freject invitations [Required]\n4. `BOX_GET_COLLABORATION` - Get details of a specific collaboration [Optional]\n5. `BOX_UPDATE_FILE` - Create shared links, lock files, or update permissions [Optional]\n6. `BOX_UPDATE_FOLDER` - Create shared links on folders [Optional]\n\n**Key parameters**:\n- `collaboration_id`: Unique collaboration identifier\n- `role`: Access level (`\"editor\"`, `\"viewer\"`, `\"co-owner\"`, `\"owner\"`, `\"previewer\"`, `\"uploader\"`, `\"viewer uploader\"`, `\"previewer uploader\"`)\n- `status`: `\"accepted\"`, `\"pending\"`, or `\"rejected\"` for collaboration invites\n- `file_id`: File to share or manage\n- `lock__access`: Set to `\"lock\"` to lock a file\n- `permissions__can__download`: `\"company\"` or `\"open\"` for download permissions\n\n**Pitfalls**:\n- Only certain roles can invite collaborators; insufficient permissions cause authorization errors\n- `can_view_path` increases load time for the invitee's \"All Files\" page; limit to 1000 per user\n- Collaboration expiration requires enterprise admin settings to be enabled\n- Nested parameter names use double underscores (e.g., `lock__access`, `parent__id`)\n\n### 5. Box Sign Requests\n\n**When to use**: User wants to manage document signature requests\n\n**Tool sequence**:\n1. `BOX_LIST_BOX_SIGN_REQUESTS` - List all signature requests [Required]\n2. `BOX_GET_BOX_SIGN_REQUEST_BY_ID` - Get details of a specific sign request [Optional]\n3. `BOX_CANCEL_BOX_SIGN_REQUEST` - Cancel a pending sign request [Optional]\n\n**Key parameters**:\n- `sign_request_id`: UUID of the sign request\n- `shared_requests`: Set `true` to include requests where user is a collaborator (not owner)\n- `senders`: Filter by sender emails (requires `shared_requests: true`)\n- `limit` \u002F `marker`: Pagination parameters\n\n**Pitfalls**:\n- Requires Box Sign to be enabled for the enterprise account\n- Deleted sign files or parent folders cause requests to not appear in listings\n- Only the creator can cancel a sign request\n- Sign request statuses include: `converting`, `created`, `sent`, `viewed`, `signed`, `declined`, `cancelled`, `expired`, `error_converting`, `error_sending`\n\n## Common Patterns\n\n### ID Resolution\nBox uses numeric string IDs for all entities:\n- **Root folder**: Always ID `\"0\"`\n- **File ID from URL**: `https:\u002F\u002F*.app.box.com\u002Ffiles\u002F123` gives file_id `\"123\"`\n- **Folder ID from URL**: `https:\u002F\u002F*.app.box.com\u002Ffolder\u002F123` gives folder_id `\"123\"`\n- **Search to ID**: Use `BOX_SEARCH_FOR_CONTENT` to find items, then extract IDs from results\n- **ETag**: Use `if_match` with file's ETag for safe concurrent delete operations\n\n### Pagination\nBox supports two pagination methods:\n- **Offset-based**: Use `offset` + `limit` (max offset 10000)\n- **Marker-based**: Set `usemarker: true` and follow `marker` from responses (preferred for large datasets)\n- Always paginate to completion to avoid partial results\n\n### Nested Parameters\nBox tools use double underscore notation for nested objects:\n- `parent__id` for parent folder reference\n- `lock__access`, `lock__expires__at`, `lock__is__download__prevented` for file locks\n- `permissions__can__download` for download permissions\n\n## Known Pitfalls\n\n### ID Formats\n- All IDs are numeric strings (e.g., `\"123456\"`, not integers)\n- Root folder is always `\"0\"`\n- File and folder IDs can be extracted from Box web app URLs\n\n### Rate Limits\n- Box API has per-endpoint rate limits\n- Search and list operations should use pagination responsibly\n- Bulk operations should include delays between requests\n\n### Parameter Quirks\n- `fields` parameter changes response shape: when specified, only mini representation + requested fields are returned\n- Search requires either `query` or `mdfilters`; both are optional individually but one must be present\n- `BOX_UPDATE_FILE` with `lock` set to `null` removes the lock (raw API only)\n- Metadata query `from` field format: `enterprise_{enterprise_id}.templateKey` or `global.templateKey`\n\n### Permissions\n- Deletions fail without sufficient permissions; always handle error responses\n- Collaboration roles determine what operations are allowed\n- Enterprise settings may restrict certain sharing options\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| Search content | `BOX_SEARCH_FOR_CONTENT` | `query`, `type`, `ancestor_folder_ids` |\n| List folder items | `BOX_LIST_ITEMS_IN_FOLDER` | `folder_id`, `limit`, `marker` |\n| Get file info | `BOX_GET_FILE_INFORMATION` | `file_id`, `fields` |\n| Get folder info | `BOX_GET_FOLDER_INFORMATION` | `folder_id`, `fields` |\n| Upload file | `BOX_UPLOAD_FILE` | `file`, `parent_id` |\n| Download file | `BOX_DOWNLOAD_FILE` | `file_id` |\n| Create folder | `BOX_CREATE_FOLDER` | `name`, `parent__id` |\n| Update folder | `BOX_UPDATE_FOLDER` | `folder_id`, `name`, `parent` |\n| Copy folder | `BOX_COPY_FOLDER` | `folder_id`, `parent__id` |\n| Delete folder | `BOX_DELETE_FOLDER` | `folder_id`, `recursive` |\n| Permanently delete folder | `BOX_PERMANENTLY_REMOVE_FOLDER` | folder_id |\n| Update file | `BOX_UPDATE_FILE` | `file_id`, `name`, `parent__id` |\n| Delete file | `BOX_DELETE_FILE` | `file_id`, `if_match` |\n| List collaborations | `BOX_LIST_FILE_COLLABORATIONS` | `file_id` |\n| Update collaboration | `BOX_UPDATE_COLLABORATION` | `collaboration_id`, `role` |\n| Get collaboration | `BOX_GET_COLLABORATION` | `collaboration_id` |\n| Query by metadata | `BOX_QUERY_FILES_FOLDERS_BY_METADATA` | `from`, `ancestor_folder_id`, `query` |\n| List collections | `BOX_LIST_ALL_COLLECTIONS` | (none) |\n| List collection items | `BOX_LIST_COLLECTION_ITEMS` | `collection_id` |\n| List sign requests | `BOX_LIST_BOX_SIGN_REQUESTS` | `limit`, `marker` |\n| Get sign request | `BOX_GET_BOX_SIGN_REQUEST_BY_ID` | `sign_request_id` |\n| Cancel sign request | `BOX_CANCEL_BOX_SIGN_REQUEST` | `sign_request_id` |\n| Recent items | `BOX_LIST_RECENTLY_ACCESSED_ITEMS` | (none) |\n| Create zip download | `BOX_CREATE_ZIP_DOWNLOAD` | item IDs |\n","# Box Automation via Rube MCP\n\nAutomate Box operations including file upload\u002Fdownload, content search, folder management, collaboration, metadata queries, and sign requests through Composio's Box toolkit.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Box connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `box`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https:\u002F\u002Frube.app\u002Fmcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `box`\n3. If connection is not ACTIVE, follow the returned auth link to complete Box OAuth\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Upload and Download Files\n\n**When to use**: User wants to upload files to Box or download files from it\n\n**Tool sequence**:\n1. `BOX_SEARCH_FOR_CONTENT` - Find the target folder if path is unknown [Prerequisite]\n2. `BOX_GET_FOLDER_INFORMATION` - Verify folder exists and get folder_id [Prerequisite]\n3. `BOX_LIST_ITEMS_IN_FOLDER` - Browse folder contents and discover file IDs [Optional]\n4. `BOX_UPLOAD_FILE` - Upload a file to a specific folder [Required for upload]\n5. `BOX_DOWNLOAD_FILE` - Download a file by file_id [Required for download]\n6. `BOX_CREATE_ZIP_DOWNLOAD` - Bundle multiple files\u002Ffolders into a zip [Optional]\n\n**Key parameters**:\n- `parent_id`: Folder ID for upload destination (use `\"0\"` for root folder)\n- `file`: FileUploadable object with `s3key`, `mimetype`, and `name` for uploads\n- `file_id`: Unique file identifier for downloads\n- `version`: Optional file version ID for downloading specific versions\n- `fields`: Comma-separated list of attributes to return\n\n**Pitfalls**:\n- Uploading to a folder with existing filenames can trigger conflict behavior; decide overwrite vs rename semantics\n- Files over 50MB should use chunk upload APIs (not available via standard tools)\n- The `attributes` part of upload must come before the `file` part or you get HTTP 400 with `metadata_after_file_contents`\n- File IDs and folder IDs are numeric strings extractable from Box web app URLs (e.g., `https:\u002F\u002F*.app.box.com\u002Ffiles\u002F123` gives file_id `\"123\"`)\n\n### 2. Search and Browse Content\n\n**When to use**: User wants to find files, folders, or web links by name, content, or metadata\n\n**Tool sequence**:\n1. `BOX_SEARCH_FOR_CONTENT` - Full-text search across files, folders, and web links [Required]\n2. `BOX_LIST_ITEMS_IN_FOLDER` - Browse contents of a specific folder [Optional]\n3. `BOX_GET_FILE_INFORMATION` - Get detailed metadata for a specific file [Optional]\n4. `BOX_GET_FOLDER_INFORMATION` - Get detailed metadata for a specific folder [Optional]\n5. `BOX_QUERY_FILES_FOLDERS_BY_METADATA` - Search by metadata template values [Optional]\n6. `BOX_LIST_RECENTLY_ACCESSED_ITEMS` - List recently accessed items [Optional]\n\n**Key parameters**:\n- `query`: Search string supporting operators (`\"\"` exact match, `AND`, `OR`, `NOT` - uppercase only)\n- `type`: Filter by `\"file\"`, `\"folder\"`, or `\"web_link\"`\n- `ancestor_folder_ids`: Limit search to specific folders (comma-separated IDs)\n- `file_extensions`: Filter by file type (comma-separated, no dots)\n- `content_types`: Search in `\"name\"`, `\"description\"`, `\"file_content\"`, `\"comments\"`, `\"tags\"`\n- `created_at_range` \u002F `updated_at_range`: Date filters as comma-separated RFC3339 timestamps\n- `limit`: Results per page (default 30)\n- `offset`: Pagination offset (max 10000)\n- `folder_id`: For `LIST_ITEMS_IN_FOLDER` (use `\"0\"` for root)\n\n**Pitfalls**:\n- Queries with offset > 10000 are rejected with HTTP 400\n- `BOX_SEARCH_FOR_CONTENT` requires either `query` or `mdfilters` parameter\n- Misconfigured filters can silently omit expected items; validate with small test queries first\n- Boolean operators (`AND`, `OR`, `NOT`) must be uppercase\n- `BOX_LIST_ITEMS_IN_FOLDER` requires pagination via `marker` or `offset`\u002F`usemarker`; partial listings are common\n- Standard folders sort items by type first (folders before files before web links)\n\n### 3. Manage Folders\n\n**When to use**: User wants to create, update, move, copy, or delete folders\n\n**Tool sequence**:\n1. `BOX_GET_FOLDER_INFORMATION` - Verify folder exists and check permissions [Prerequisite]\n2. `BOX_CREATE_FOLDER` - Create a new folder [Required for create]\n3. `BOX_UPDATE_FOLDER` - Rename, move, or update folder settings [Required for update]\n4. `BOX_COPY_FOLDER` - Copy a folder to a new location [Optional]\n5. `BOX_DELETE_FOLDER` - Move folder to trash [Required for delete]\n6. `BOX_PERMANENTLY_REMOVE_FOLDER` - Permanently delete a trashed folder [Optional]\n\n**Key parameters**:\n- `name`: Folder name (no `\u002F`, `\\`, trailing spaces, or `.`\u002F`..`)\n- `parent__id`: Parent folder ID (use `\"0\"` for root)\n- `folder_id`: Target folder ID for operations\n- `parent.id`: Destination folder ID for moves via `BOX_UPDATE_FOLDER`\n- `recursive`: Set `true` to delete non-empty folders\n- `shared_link`: Object with `access`, `password`, `permissions` for creating shared links on folders\n- `description`, `tags`: Optional metadata fields\n\n**Pitfalls**:\n- `BOX_DELETE_FOLDER` moves to trash by default; use `BOX_PERMANENTLY_REMOVE_FOLDER` for permanent deletion\n- Non-empty folders require `recursive: true` for deletion\n- Root folder (ID `\"0\"`) cannot be copied or deleted\n- Folder names cannot contain `\u002F`, `\\`, non-printable ASCII, or trailing spaces\n- Moving folders requires setting `parent.id` via `BOX_UPDATE_FOLDER`\n\n### 4. Share Files and Manage Collaborations\n\n**When to use**: User wants to share files, manage access, or handle collaborations\n\n**Tool sequence**:\n1. `BOX_GET_FILE_INFORMATION` - Get file details and current sharing status [Prerequisite]\n2. `BOX_LIST_FILE_COLLABORATIONS` - List who has access to a file [Required]\n3. `BOX_UPDATE_COLLABORATION` - Change access level or accept\u002Freject invitations [Required]\n4. `BOX_GET_COLLABORATION` - Get details of a specific collaboration [Optional]\n5. `BOX_UPDATE_FILE` - Create shared links, lock files, or update permissions [Optional]\n6. `BOX_UPDATE_FOLDER` - Create shared links on folders [Optional]\n\n**Key parameters**:\n- `collaboration_id`: Unique collaboration identifier\n- `role`: Access level (`\"editor\"`, `\"viewer\"`, `\"co-owner\"`, `\"owner\"`, `\"previewer\"`, `\"uploader\"`, `\"viewer uploader\"`, `\"previewer uploader\"`)\n- `status`: `\"accepted\"`, `\"pending\"`, or `\"rejected\"` for collaboration invites\n- `file_id`: File to share or manage\n- `lock__access`: Set to `\"lock\"` to lock a file\n- `permissions__can__download`: `\"company\"` or `\"open\"` for download permissions\n\n**Pitfalls**:\n- Only certain roles can invite collaborators; insufficient permissions cause authorization errors\n- `can_view_path` increases load time for the invitee's \"All Files\" page; limit to 1000 per user\n- Collaboration expiration requires enterprise admin settings to be enabled\n- Nested parameter names use double underscores (e.g., `lock__access`, `parent__id`)\n\n### 5. Box Sign Requests\n\n**When to use**: User wants to manage document signature requests\n\n**Tool sequence**:\n1. `BOX_LIST_BOX_SIGN_REQUESTS` - List all signature requests [Required]\n2. `BOX_GET_BOX_SIGN_REQUEST_BY_ID` - Get details of a specific sign request [Optional]\n3. `BOX_CANCEL_BOX_SIGN_REQUEST` - Cancel a pending sign request [Optional]\n\n**Key parameters**:\n- `sign_request_id`: UUID of the sign request\n- `shared_requests`: Set `true` to include requests where user is a collaborator (not owner)\n- `senders`: Filter by sender emails (requires `shared_requests: true`)\n- `limit` \u002F `marker`: Pagination parameters\n\n**Pitfalls**:\n- Requires Box Sign to be enabled for the enterprise account\n- Deleted sign files or parent folders cause requests to not appear in listings\n- Only the creator can cancel a sign request\n- Sign request statuses include: `converting`, `created`, `sent`, `viewed`, `signed`, `declined`, `cancelled`, `expired`, `error_converting`, `error_sending`\n\n## Common Patterns\n\n### ID Resolution\nBox uses numeric string IDs for all entities:\n- **Root folder**: Always ID `\"0\"`\n- **File ID from URL**: `https:\u002F\u002F*.app.box.com\u002Ffiles\u002F123` gives file_id `\"123\"`\n- **Folder ID from URL**: `https:\u002F\u002F*.app.box.com\u002Ffolder\u002F123` gives folder_id `\"123\"`\n- **Search to ID**: Use `BOX_SEARCH_FOR_CONTENT` to find items, then extract IDs from results\n- **ETag**: Use `if_match` with file's ETag for safe concurrent delete operations\n\n### Pagination\nBox supports two pagination methods:\n- **Offset-based**: Use `offset` + `limit` (max offset 10000)\n- **Marker-based**: Set `usemarker: true` and follow `marker` from responses (preferred for large datasets)\n- Always paginate to completion to avoid partial results\n\n### Nested Parameters\nBox tools use double underscore notation for nested objects:\n- `parent__id` for parent folder reference\n- `lock__access`, `lock__expires__at`, `lock__is__download__prevented` for file locks\n- `permissions__can__download` for download permissions\n\n## Known Pitfalls\n\n### ID Formats\n- All IDs are numeric strings (e.g., `\"123456\"`, not integers)\n- Root folder is always `\"0\"`\n- File and folder IDs can be extracted from Box web app URLs\n\n### Rate Limits\n- Box API has per-endpoint rate limits\n- Search and list operations should use pagination responsibly\n- Bulk operations should include delays between requests\n\n### Parameter Quirks\n- `fields` parameter changes response shape: when specified, only mini representation + requested fields are returned\n- Search requires either `query` or `mdfilters`; both are optional individually but one must be present\n- `BOX_UPDATE_FILE` with `lock` set to `null` removes the lock (raw API only)\n- Metadata query `from` field format: `enterprise_{enterprise_id}.templateKey` or `global.templateKey`\n\n### Permissions\n- Deletions fail without sufficient permissions; always handle error responses\n- Collaboration roles determine what operations are allowed\n- Enterprise settings may restrict certain sharing options\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| Search content | `BOX_SEARCH_FOR_CONTENT` | `query`, `type`, `ancestor_folder_ids` |\n| List folder items | `BOX_LIST_ITEMS_IN_FOLDER` | `folder_id`, `limit`, `marker` |\n| Get file info | `BOX_GET_FILE_INFORMATION` | `file_id`, `fields` |\n| Get folder info | `BOX_GET_FOLDER_INFORMATION` | `folder_id`, `fields` |\n| Upload file | `BOX_UPLOAD_FILE` | `file`, `parent_id` |\n| Download file | `BOX_DOWNLOAD_FILE` | `file_id` |\n| Create folder | `BOX_CREATE_FOLDER` | `name`, `parent__id` |\n| Update folder | `BOX_UPDATE_FOLDER` | `folder_id`, `name`, `parent` |\n| Copy folder | `BOX_COPY_FOLDER` | `folder_id`, `parent__id` |\n| Delete folder | `BOX_DELETE_FOLDER` | `folder_id`, `recursive` |\n| Permanently delete folder | `BOX_PERMANENTLY_REMOVE_FOLDER` | folder_id |\n| Update file | `BOX_UPDATE_FILE` | `file_id`, `name`, `parent__id` |\n| Delete file | `BOX_DELETE_FILE` | `file_id`, `if_match` |\n| List collaborations | `BOX_LIST_FILE_COLLABORATIONS` | `file_id` |\n| Update collaboration | `BOX_UPDATE_COLLABORATION` | `collaboration_id`, `role` |\n| Get collaboration | `BOX_GET_COLLABORATION` | `collaboration_id` |\n| Query by metadata | `BOX_QUERY_FILES_FOLDERS_BY_METADATA` | `from`, `ancestor_folder_id`, `query` |\n| List collections | `BOX_LIST_ALL_COLLECTIONS` | (none) |\n| List collection items | `BOX_LIST_COLLECTION_ITEMS` | `collection_id` |\n| List sign requests | `BOX_LIST_BOX_SIGN_REQUESTS` | `limit`, `marker` |\n| Get sign request | `BOX_GET_BOX_SIGN_REQUEST_BY_ID` | `sign_request_id` |\n| Cancel sign request | `BOX_CANCEL_BOX_SIGN_REQUEST` | `sign_request_id` |\n| Recent items | `BOX_LIST_RECENTLY_ACCESSED_ITEMS` | (none) |\n| Create zip download | `BOX_CREATE_ZIP_DOWNLOAD` | item IDs |\n",{"name":5,"requires":49,"description":7},{"mcp":50},[51],"rube","main","def8531e65114c0fca8fb8551c1871ee0eed705c","skills\u002Faiskillstore\u002Fmarketplace\u002Fsickn33\u002Fbox-automation",24,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub","https:\u002F\u002Fskillshub.wtf","https:\u002F\u002Fgithub.com\u002FComeOnOliver","AI & Blockchain Engineer\r\n","2026-06-24 22:07:19",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add ComeOnOliver\u002Fskillshub --skill box-automation",{"tool":67,"command":68},"bunx","bunx skills add ComeOnOliver\u002Fskillshub --skill box-automation",{"tool":70,"command":71},"pnpm","pnpm dlx skills add ComeOnOliver\u002Fskillshub --skill box-automation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Faiskillstore\u002Fmarketplace\u002Fsickn33\u002Fbox-automation\u002FSKILL.md",true,[75],{"path":76,"resourceType":77,"resourceTypeDesc":78,"sizeBytes":79,"sourceHtmlUrl":80},"skill-report.json","REFERENCE","参考文档",12148,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Faiskillstore\u002Fmarketplace\u002Fsickn33\u002Fbox-automation\u002Fskill-report.json",[82,92,101,110,116,123],{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":88,"publishedAt":44},"01M6FKJN13GMG4KY57J3QD8GY5","model-hierarchy-skill","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzscole\u002Fmodel-hierarchy-skill\u002Fmodel-hierarchy-skill\u002FSKILL.md",[87],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[89,90,91],"model","model hierarchy","model hierarchy skill",{"skillNo":93,"name":94,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":98,"publishedAt":44},"01M6FKJJJ6GCAMR4PPPRD12M5X","zoom-mcp","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-mcp\u002FSKILL.md",[97],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[28,99,100],"zoom","zoom mcp",{"skillNo":102,"name":103,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":44},"01M6FKJE3KYT3KPEZMEEHYKA6K","zoom-apps-sdk","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[107,108,109,99],"sdk","zoom apps sdk","apps",{"skillNo":111,"name":112,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":44},"01M6FKJ9EDH9Q5VWDF8HAJRSP0","windows","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwindows\u002FSKILL.md",[],[112],{"skillNo":117,"name":118,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":122,"publishedAt":44},"01M6FKJ666BEEFC3AE9GJ72Q93","whiteboard","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwhiteboard\u002FSKILL.md",[121],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[118],{"skillNo":124,"name":125,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":44},"01M6FKJ21WFCDGTJQ2Q91T9DVW","websockets","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[125]]