Remove file version

delete

https://api.box.com/2.0

/files/:file_id/versions/:file_version_id

Move a file version to the trash.

Versions are only tracked for Box users with premium accounts.

Request

authorizationbearer [ACCESS_TOKEN]

content-typeapplication/json

Path Parameters

file_id stringin pathrequired

example12345

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

file_version_id stringin pathrequired

example1234

The ID of the file version

Request Headers

if-match stringin headeroptional

example1

Ensures 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

204none

Returns an empty response when the file has been successfully deleted.

defaultapplication/jsonClient error

An unexpected client error.

delete

Remove file version

You can now try out some of our APIs live, right here in the documentation.

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
	});