Box download file

box__download_file

Returns base64 content, content type and byte size; maximum 128 KiB.

Access

Requires a project integration connection for box.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
fileIdstringYesBox file ID. A 202 response with Retry-After means the file is not ready; wait for the indicated delay before retrying.
versionstringNoSpecific file version to download; omit for the current version

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "box__download_file",
    "arguments": {
      "fileId": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the box integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "fileId": {
      "type": "string",
      "description": "Box file ID. A 202 response with Retry-After means the file is not ready; wait for the indicated delay before retrying."
    },
    "version": {
      "type": "string",
      "description": "Specific file version to download; omit for the current version"
    }
  },
  "required": [
    "fileId"
  ],
  "description": "Arguments for the box__download_file tool."
}