Connect Claude to Box

Return the Box identity this connection authenticates as - its user ID, name, login, and status. With the default enterprise subject type that is the app's Service Account rather than a person, and its ID is what a folder has to be collaborated to before this connector can see the folder. It reads no file, which makes it the right proof that the credential works.

List what is directly inside one folder - its files, subfolders and web links. The root folder of any Box account is always id "0", which is where to start. Box returns a small "mini" representation of each item by default, so this asks for a useful set of fields instead; widen or narrow it with `fields`. For a folder with more entries than one page holds, set use_marker true and pass the `next_marker` from the response back as `marker`.

Read one folder's own details - its name, where it sits, when it changed, how big it is, and whether it already has a shared link. Use "0" for the account root. This does not list what is inside it; that is list_folder_items.

Read one file's details - its name, size, type, the folder it sits in, when it last changed, and whether it already has a shared link. This returns information about the file, not its contents: downloading bytes is a different Box host and this connector does not carry it.

Search Box for files, folders and web links. The query matches names, descriptions and the text inside documents, and supports "exact phrase" in double quotes together with AND, OR and NOT in capitals. Narrow it with `type` to one kind of item, with `ancestor_folder_ids` to look inside particular folders, or with `content_types` to say where the words should appear. The default scope is what this connection can already reach; enterprise_content searches the whole enterprise and has to be enabled by Box support first.

List who has been given access to one file and in what role - editor, viewer, previewer, uploader, co-owner and so on. Read it before create_shared_link to see whether the person who needs the file already has it, which is the reversible way to give somebody access.

List the people in this Box enterprise, optionally narrowed by a name or login prefix. Their IDs are what a collaboration is granted to. Reading this needs an identity with admin rights in the enterprise, which the Service Account has by default. Note that user_type "external" and "all" reach beyond the enterprise's own staff to people outside it.

Put a shared link on a file. Classified destructive, alongside deleting: with access "open" the link works for anybody who has the URL, signed in to Box or not, and a URL that has been sent somewhere cannot be un-sent. "company" keeps it inside the enterprise and needs a paid plan; "collaborators" only works for people already invited to the file, which is the safe default when a link is wanted for convenience rather than for sharing. Setting `unshared_at` bounds the exposure. Box replaces any link the file already had, so read get_file first to see whether one exists.

Delete one file. Box moves it to the enterprise's trash, where it stays recoverable for the retention window an admin has set - 30 days by default - and is then removed for good. Pass `if_match` with the file's `etag` from get_file to have Box refuse the delete if somebody has changed the file since it was read. Box answers with an empty 204 on success.

Delete one folder. Box refuses a folder that still has anything in it unless `recursive` is true, and recursive deletion takes every file and subfolder with it. Everything goes to the enterprise's trash and is recoverable for the retention window an admin has set. Box answers with an empty 204 on success.