Join BoxWorks 2024 to discover what's possible with content and AI!
Register now!Remove file version
Move a file version to the trash.
Versions are only tracked for Box users with premium accounts.
Request
bearer [ACCESS_TOKEN]
application/json
Path Parameters
stringin pathrequired
12345The unique identifier that represents a file.
The ID for any file can be determined
by visiting a file in the web application
and copying the ID from the URL. For example,
for the URL https://*.app.box.com/files/123
the file_id is 123.
stringin pathrequired
1234The ID of the file version
Request Headers
stringin headeroptional
1Ensures this item hasn't recently changed before making changes.
Pass in the item's last observed etag value
into this header and the endpoint will fail
with a 412 Precondition Failed if it
has changed since.
Response
none
Returns an empty response when the file has been successfully deleted.
application/jsonClient error
An unexpected client error.
Request Example
cURL
curl -i -X DELETE "https://api.box.com/2.0/files/12345/versions/456456" \
-H "authorization: Bearer <ACCESS_TOKEN>"TypeScript Gen
await client.fileVersions.deleteFileVersionById(file.id, fileVersion.id);Python Gen
client.file_versions.delete_file_version_by_id(file.id, file_version.id).NET Gen
await client.FileVersions.DeleteFileVersionByIdAsync(fileId: file.Id, fileVersionId: fileVersion.Id);Swift Gen (Beta)
try await client.fileVersions.deleteFileVersionById(fileId: file.id, fileVersionId: fileVersion.id)Java
BoxFile file = new BoxFile(api, "id");
Collection<BoxFileVersion> versions = file.getVersions();
BoxFileVersion firstVersion = versions.iterator().next();
firstVersion.delete();Python
file_id = '11111'
version_id = '12345'
version_to_delete = client.file_version(version_id)
client.file(file_id).delete_version(version_to_delete).NET
string fileId = "11111";
await client.FilesManager.DeleteOldVersionAsync(fileId, versionId: "22222");Node
var fileID = '11111';
var versionID = '22222';
client.files.deleteVersion(fileID, versionID)
.then(() => {
// deletion succeeded — no value returned
});