> ## 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

> Upload file (50 MB maximum)

`box__upload_file`

## Access

Requires a project integration connection for `box`.

**Call type:** Can change resources.

## Arguments

| Field | Type | Required | Description and constraints |
| - | - | - | - |
| `fields` | `string` | No | Comma-separated attribute list to include in the response |
| `attributes` | `object` | Yes | File metadata sent as the multipart 'attributes' part (Box requires it to precede the file part), e.g. \{ "name": "report.pdf", "parent": \{ "id": "0" } }; the name must be unique within the parent folder |
| `file` | `string` | Yes | Base64-encoded 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.pdf; should match the name in attributes |

## 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",
    "arguments": {
      "attributes": {
        "name": "example.txt",
        "parent": {
          "id": "0"
        }
      },
      "file": "SGVsbG8gQm94Cg==",
      "file_name": "example.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": {
    "fields": {
      "type": "string",
      "description": "Comma-separated attribute list to include in the response"
    },
    "attributes": {
      "type": "object",
      "description": "File metadata sent as the multipart 'attributes' part (Box requires it to precede the file part), e.g. { \"name\": \"report.pdf\", \"parent\": { \"id\": \"0\" } }; the name must be unique within the parent folder"
    },
    "file": {
      "type": "string",
      "description": "Base64-encoded 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.pdf; should match the name in attributes"
    }
  },
  "required": [
    "attributes",
    "file",
    "file_name"
  ],
  "description": "Arguments for the box__upload_file 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` 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.