Delete Version

Permanently delete a specific version of an object.
EndpointMethodAdmin Required
/api/v1/objects/versionDELETENo

Permanently deletes a specific version of an object. This bypasses delete markers and removes the version from storage.

This action is irreversible. The specified version will be permanently deleted.

Query Parameters

bucket
string required
Name of the bucket.
key
string required
Object key.
versionId
string required
The version ID to delete.

Response

Returns 204 No Content on success.

Use Cases

  • Remove delete markers: Delete the delete marker version to "undelete" an object
  • Clean up old versions: Permanently remove outdated versions to free storage
  • Compliance: Remove specific versions that need to be purged

Example

curl -X DELETE "{API_BASE_URL}/api/v1/objects/version?bucket=my-bucket&key=report.pdf&versionId=abc123def456" \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "X-Secret-Key: YOUR_SECRET_KEY"

Errors

StatusReason
400Missing bucket, key, or versionId parameter
404Bucket not found (or not owned by you)

List Versions

List all versions of a specific object.