Upload File Version

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

• 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.