GET STARTED WITH APIs
Overview
ENDPOINTS
Upload File
Digital Asset Management (DAM)
Custom metadata fields
Managing assets
Get file details
get
Update file details
patch
Delete file
delete
Delete multiple files
post
Copy file
post
Move file
post
Rename file
put
List file versions
get
Get file version details
get
Delete file version
delete
Restore file version
put
Add tags (bulk)
post
Remove tags (bulk)
post
Remove AI tags (bulk)
post
List and search assets
get
Managing folders
Caching
File Metadata
Account Management API
delete
https://api.imagekit.io
/v1/files/{fileId}/versions/{versionId}

This API deletes a non-current file version permanently. The API returns an empty response.

Note: If you want to delete all versions of a file, use the delete file API.

Request

fileId
string
required

The unique fileId of the uploaded file. fileId is returned in list and search assets API and upload API.

versionId
string
required

The unique versionId of the uploaded file. versionId is returned in list and search assets API and upload API.

Auth
API key
:
Parameters
:
:
Note

Here, you can explore machine-generated code examples. For practical applications, refer to the examples section below, which includes detailed code snippets from the ImageKit SDKs.

curl --request DELETE \
  --url https://api.imagekit.io/v1/files/fileId/versions/versionId \
  --header 'Accept: application/json' \
  --header 'Authorization: Basic 123'

Responses

File version deleted successfully.

Body

1
{}

Examples

Here is the example request to understand the API usage.

Copy
# The unique fileId and versionId of the uploaded file. fileId and versionId (versionInfo.id) is returned in response of list files API and upload API.
curl -X DELETE "https://api.imagekit.io/v1/files/file_id/versions/version_id" \
-u your_private_api_key:

var ImageKit = require("imagekit");

var imagekit = new ImageKit({
    publicKey : "your_public_api_key",
    privateKey : "your_private_api_key",
    urlEndpoint : "https://ik.imagekit.io/your_imagekit_id/"
});

var fileId = "file_id";
var versionId = "version_id"

imagekit.deleteFileVersion({
     fileId,
     versionId
}, function(error, result) {
    if(error) console.log(error);
    else console.log(result);
});

from imagekitio import ImageKit

imagekit = ImageKit(
    public_key='your_public_api_key',
    private_key='your_private_api_key',
    url_endpoint = 'https://ik.imagekit.io/your_imagekit_id/'
)

delete_file_version = imagekit.delete_file_version(file_id="file_id", version_id="version_id")

print("Delete file version-", delete_file_version, end="\n\n")

# Raw Response
print(delete_file_version.response_metadata.raw)

$public_key = "your_public_api_key";
$your_private_key = "your_private_api_key";
$url_end_point = "https://ik.imagekit.io/your_imagekit_id";

$imageKit = new ImageKit(
    $public_key,
    $your_private_key,
    $url_end_point
);

$fileId = 'file_id';
$versionId = 'version_id';

$deleteFileVersion = $imageKit->deleteFileVersion($fileId, $versionId);

DeleteFileVersionRequest deleteFileVersionRequest = new DeleteFileVersionRequest();
deleteFileVersionRequest.setFileId("file_id");
deleteFileVersionRequest.setVersionId("version_id");
ResultNoContent resultNoContent = ImageKit.getInstance().deleteFileVersion(deleteFileVersionRequest);

imagekitio.delete_file_version(
    file_id: 'file_id',
    version_id: 'version_id'
)

resp, err := ik.Media.DeleteFileVersion(ctx, "file_id", "version_id")

var imagekit = new ImageKit({
    publicKey : "your_public_api_key",
    privateKey : "your_private_api_key",
    urlEndpoint : "https://ik.imagekit.io/your_imagekit_id/"
});
DeleteFileVersionRequest delRequest = new DeleteFileVersionRequest
    {
        fileId = "file_Id",
        versionId = "version_Id"
    };
ResultNoContent resultNoContent1 = imagekit.DeleteFileVersion(delRequest);