Box

Integrate Box cloud storage into your workflows to upload and download files, browse folder contents, create folders, manage sharing links, and retrieve file metadata — all authenticated via OAuth.

Overview

Operations

Configuration

Outputs

Upload File (box_upload_file)

Download File (box_download_file)

List Folder (box_list_folder)

Create Folder (box_create_folder)

Delete File (box_delete_file)

Get File Info (box_get_file_info)

Create Shared Link (box_create_shared_link)

Example

[Starter] → [Box: Upload File] → [Agent: analyze the uploaded file] → [Box: Create Shared Link]

When a workflow is triggered, the Starter block passes a file (e.g. from {{starter.file}}) to the Box: Upload File block, setting folderId to {{BOX_REPORTS_FOLDER_ID}} and fileName to {{starter.fileName}}. The resulting {{box.id}} is then handed to Box: Create Shared Link so an Agent can include the public {{box.url}} in a summary or notification.

Tips

• Finding a file or folder ID — open the item in the Box web app; the numeric ID appears at the end of the URL (e.g. https://app.box.com/folder/123456789).
• Root folder — use "0" as the folderId for any operation that targets the top-level folder of the connected account.
• Download readiness — Box may return HTTP 202 while a file is being processed. If the Download File operation throws a "not yet ready" error, add a short Wait block before retrying.
• Shared link access — the Create Shared Link tool always creates an open (anyone with the link) shared link. If you need restricted access (company or collaborators only), update the link via the Box web UI or a custom HTTP block after creation.
• Upload via proxy — the Upload File tool routes through the internal /api/tools/box/upload endpoint rather than calling Box directly, so the OAuth token is never exposed in the browser for file payloads.