Cmdlets for Box

Build 25.0.9434

UploadFileVersion

Uploads a new version of an existing file, maintaining version history in Box.

Input

Name Type Description
FilePath String The full local path of the file, including its name, for the new version upload.
FileId String The unique identifier of the file whose version is being updated.
NewName String An optional new name for the file. If provided, the file is renamed during the upload of the new version. The name must include the file extension (for example, SampleFile.txt).
AsUserId String The Id of the user to impersonate when uploading the new version. Only works with Admin, Co-Admin, and Service Accounts.
ModifiedAt Datetime An optional timestamp indicating when the file was last modified. If not set, the upload time is used. Example format: '2020-01-01T12:00:00-05:00'.
Hash String An optional SHA1 hash of the file used to verify the file's integrity during upload.
IfMatch String An optional concurrency control header. Provide the file's most recent etag to ensure it has not changed before updating. If the etag does not match, the request fails with a 412 Precondition Failed.

Result Set Columns

Name Type Description
Success String Indicates whether the new file version was uploaded successfully.
ID String The unique identifier of the updated file.
VersionID String The identifier for the specific version of the file that was uploaded.
Hash String The SHA1 hash of the uploaded file version, used for integrity verification.
Etag String The entity tag of the updated file, used for versioning and concurrency control.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9434