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

# Box upload file version

> Upload file version (50 MB maximum)

`box__upload_file_version`

## Access

Requires a project integration connection for `box`.

**Call type:** Can change resources.

## Arguments

| Field | Type | Required | Description and constraints |
| - | - | - | - |
| `fileId` | `string` | Yes | Box file ID to upload a new version of |
| `attributes` | `object` | Yes | 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` | `string` | Yes | 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` | `string` | Yes | Filename 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](/docs/cloud/getting-started/connect-mcp.md).

```json title="request.json" theme={null}
{
  "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](/docs/cloud/integrations/box.md) for provider setup and tool context.

## Full schemas

```json title="input-schema.json" theme={null}
{
  "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."
}
```

<details>
  <summary>Try this tool</summary>

  Replace sample arguments with values for your project or connected account. Calls run only when you select Run tool.

  MCP tool call

  Call `box__upload_file_version` against the Veryfront MCP endpoint.

  Bearer token or API key

  Arguments (JSON)

  Run this tool with these arguments.

  Run tool

  Output JSON

  <pre />
</details>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.