Box upload file version

box__upload_file_version

Access

Requires a project integration connection for box.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
fileIdstringYesBox file ID to upload a new version of
attributesobjectYesMetadata sent as the multipart 'attributes' part (required by Box even when not renaming, and must precede the file part), e.g. { "name": "report-v2.pdf" } to rename the file
filestringYesBase64-encoded new file content, sent decoded as the binary multipart 'file' part. The decoded file must not exceed 50 MB. Larger files require the chunked upload API, which this connector does not expose.
file_namestringYesFilename for the uploaded file part, e.g. report-v2.pdf

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__upload_file_version",
    "arguments": {
      "fileId": "1234567890",
      "attributes": {
        "name": "example-v2.txt"
      },
      "file": "SGVsbG8gQm94Cg==",
      "file_name": "example-v2.txt"
    }
  }
}

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 to upload a new version of"
    },
    "attributes": {
      "type": "object",
      "description": "Metadata sent as the multipart 'attributes' part (required by Box even when not renaming, and must precede the file part), e.g. { \"name\": \"report-v2.pdf\" } to rename the file"
    },
    "file": {
      "type": "string",
      "description": "Base64-encoded new file content, sent decoded as the binary multipart 'file' part. The decoded file must not exceed 50 MB. Larger files require the chunked upload API, which this connector does not expose."
    },
    "file_name": {
      "type": "string",
      "description": "Filename for the uploaded file part, e.g. report-v2.pdf"
    }
  },
  "required": [
    "fileId",
    "attributes",
    "file",
    "file_name"
  ],
  "description": "Arguments for the box__upload_file_version tool."
}