> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Box

> Manage files and folders, collaborations, metadata, e-signatures, and AI-powered content Q&A in Box

# Box

Shanone's Box integration gives your agent 100 tools covering Box's full content management surface — files/folders, sharing and collaboration, metadata templates, tasks, e-signatures, and Box AI's ask/extract capabilities.

## Getting Started

<Steps>
  <Step title="Connect via OAuth">
    Ask your agent to do something with Box (e.g. "find the latest contract in my Legal folder"), or connect proactively from **Integrations** in the Shanone dashboard.
  </Step>

  <Step title="Authorize your Box account">
    Approve Box's OAuth consent screen for the account/enterprise you want Shanone to access.
  </Step>

  <Step title="Retry your request">
    Once connected, `shanone_execute_tool` calls for `box_*` tools will succeed.
  </Step>
</Steps>

## Available Tools

Shanone provides **100 tools** for Box, organized into these categories:

<AccordionGroup>
  <Accordion title="Files & folders">
    `box_get_file_info`, `box_search`, `box_download_file`, `box_copy_file`, `box_move_file`, `box_rename_file`, `box_update_file`, `box_list_file_versions`, `box_get_file_version`, `box_restore_file_version`, `box_delete_file_version`, `box_list_folder`, `box_create_folder`, `box_delete_item`
  </Accordion>

  <Accordion title="Uploads & downloads">
    `box_upload_file`, `box_upload_file_version`, `box_upload_file_from_url`, `box_preflight_check`, `box_chunked_upload`, `box_get_download_url`, `box_download_file_content`, `box_get_thumbnail`, `box_get_file_representation`, `box_download_zip`
  </Accordion>

  <Accordion title="Collaboration & sharing">
    `box_list_file_collaborations`, `box_list_folder_collaborations`, `box_get_collaboration`, `box_create_collaboration`, `box_update_collaboration`, `box_delete_collaboration`, `box_get_pending_collaborations`, `box_accept_collaboration`, `box_create_shared_link`
  </Accordion>

  <Accordion title="Metadata">
    `box_list_file_metadata`, `box_get_file_metadata`, `box_create_file_metadata`, `box_update_file_metadata`, `box_delete_file_metadata`, `box_list_folder_metadata`, `box_create_folder_metadata`, `box_update_folder_metadata`, `box_list_metadata_templates`, `box_get_metadata_template`, `box_create_metadata_template`, `box_update_metadata_template`, `box_delete_metadata_template`, `box_search_by_metadata`
  </Accordion>

  <Accordion title="Comments & tasks">
    `box_list_file_comments`, `box_get_comment`, `box_create_comment`, `box_reply_to_comment`, `box_update_comment`, `box_delete_comment`, `box_list_file_tasks`, `box_get_task`, `box_create_task`, `box_update_task`, `box_delete_task`, `box_assign_task`
  </Accordion>

  <Accordion title="Users, groups & memberships">
    `box_list_users`, `box_get_user`, `box_get_current_user`, `box_create_user`, `box_update_user`, `box_delete_user`, `box_invite_user`, `box_get_user_info`, `box_list_groups`, `box_get_group`, `box_create_group`, `box_update_group`, `box_delete_group`, `box_list_group_collaborations`, `box_list_group_members`, `box_list_user_memberships`, `box_get_membership`, `box_add_group_member`, `box_remove_group_member`
  </Accordion>

  <Accordion title="AI, sign & collections">
    `box_ai_ask`, `box_ai_extract`, `box_ai_text_gen`, `box_list_sign_requests`, `box_get_sign_request`, `box_create_sign_request`, `box_cancel_sign_request`, `box_list_collections`, `box_get_collection_items`, `box_add_to_collection`, `box_remove_from_collection`
  </Accordion>

  <Accordion title="Trash, events & webhooks">
    `box_list_trashed_items`, `box_restore_item`, `box_permanently_delete`, `box_get_user_events`, `box_get_enterprise_events`, `box_long_poll_events`, `box_list_webhooks`, `box_get_webhook`, `box_create_webhook`, `box_update_webhook`, `box_delete_webhook`
  </Accordion>
</AccordionGroup>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Content Q&A" icon="message-circle-question">
    Use `box_ai_ask` to answer questions grounded in a specific file or folder's contents
  </Card>

  <Card title="Structured data extraction" icon="scan-text">
    Use `box_ai_extract` to pull structured fields out of contracts or invoices stored in Box
  </Card>

  <Card title="Contract review & e-signature" icon="file-signature">
    Search for a contract, share it with a collaborator, then create a sign request
  </Card>

  <Card title="Governed metadata tagging" icon="tags">
    Apply a metadata template to files as they're organized into folders for downstream search
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="box_ai_ask or box_ai_extract returns an unsupported file type error">
    Box AI only supports a subset of file types (mainly documents, PDFs, and some image formats) — convert the file or check the file type against Box AI's supported format list.
  </Accordion>

  <Accordion title="box_create_collaboration fails with an insufficient permission error">
    Only users with an appropriate role on the target folder can invite new collaborators. Check the requesting account's role with `box_get_collaboration` before retrying.
  </Accordion>

  <Accordion title="box_upload_file fails for a large file">
    Box requires chunked uploads above roughly 20MB. Use `box_chunked_upload` (with `box_preflight_check` first) instead of `box_upload_file` for large files.
  </Accordion>
</AccordionGroup>