Delete Version
Permanently delete a specific version of an object.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/objects/version | DELETE | No |
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
| Status | Reason |
|---|---|
400 | Missing bucket, key, or versionId parameter |
404 | Bucket not found (or not owned by you) |