Delete an object

Edit online

A DELETE given a path to an object deletes an object. This operation does not make use of operation specific query parameters (besides versioning), or payload elements.

Optional headers

Table 1. `x-amz-bypass-governance-retention`
Header	Type	Description
`x-amz-bypass-governance-retention`	string (true/false)	If the object is protected by Object Lock, deletion is only allowed when the retention period has expired, or if the object is in GOVERNANCE mode and the delete request includes the `x-amz-bypass-governance-retention: true` header. The requester must also have the required bypass permission to successfully delete the object before retention expiry.

Syntax


DELETE https://{endpoint}/{bucket-name}/{object-name} # path style
DELETE https://{bucket-name}.{endpoint}/{object-name} # virtual host style

Sample request


DELETE /example-bucket/soldier-bee HTTP/1.1
Authorization: {authorization-string}
Host: 67.228.254.193

Sample response


HTTP/1.1 204 No Content
Date: Thu, 25 Aug 2016 17:44:57 GMT
X-Clv-Request-Id: 8ff4dc32-a6f0-447f-86cf-427b564d5855
Accept-Ranges: bytes
Server: Cleversafe/3.9.0.121
X-Clv-S3-Version: 2.5