# Upload File Version

> Windows | Cross-platform

## Project compatibility

Windows | Cross-platform

## Overview

| Description | API Method | API Path |
| --- | --- | --- |
| Upload a new version of a file in Box. | POST | /files/{file_id}/content |

## Input

| Parameter | Description | Data Type |
| --- | --- | --- |
| File | The file object representing the existing file to be updated. | Data List |
| File (content) | The binary contents of the file to upload as the new version. | string |
| Content modified at | The timestamp representing when the file was last modified before being uploaded to Box. This may differ from the Box upload timestamp. | file |
| Elements-vendor-headers | Optional header containing the SHA1 hash of the file. Used to verify file integrity during upload. (The value passed under `elements-vendor-headers` is mapped to the vendor-specific `content-md5` header.) | string |
| Fields | A comma-separated list of additional fields to include in the API response. Useful for requesting fields not returned by default. | string |
| Name | The name of the file for the new version being uploaded. | string |

## Output

| Parameter | Description | Data Type |
| --- | --- | --- |
| Upload File Version | The full response payload associated with the upload file version activity. | Object |
| ID | The ID of the new file version that was uploaded. | string |
| Path collection entries id | The ID of each item in the file’s folder path hierarchy. | string |
| Created by ID | The ID of the user who originally created the file. | string |
| Version ID | The version identifier associated with the newly uploaded file version. | string |
| Parent id | The ID of the folder containing the file. | string |
| Owned by id | The ID of the user who owns the file. | string |
| Modified by id | The ID of the user who last modified the file. | string |

:::note
* In API workflows, a single response object is returned as the output. Any required fields can be extracted directly from this object.
* In RPA workflows, some output parameters may differ, but the necessary values can still be retrieved from the response object even if they are not explicitly exposed.
:::