S3 · Objects

DeleteObject

DELETE/{bucket}/{key}

Deletes an object, or one version of an object.

Without versionId, storage removes the object. In a bucket with versioning on, it adds a delete marker and keeps the versions. With versionId, storage removes that version for good.

View as Markdown

Role: Editor or higher
Support: Supported
Auth: SigV4 with your API key

With versionId, removes that version. In a versioned bucket, adds a delete marker.
A key with no object returns 404 NoSuchKey. Amazon S3 returns 204 for a missing key.
A version under object lock retention cannot be deleted before its retain-until date.

Request

https://wspq7ws2np5l8z4.storage.beta.graphon.sh/support-tickets/a.json

DELETE /support-tickets/a.json HTTP/1.1
Host: wspq7ws2np5l8z4.storage.beta.graphon.sh
x-amz-date: 20261007T093000Z
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: AWS4-HMAC-SHA256 Credential=<ACCESS_KEY_ID>/20261007/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=<SIGNATURE>

Replace wspq7ws2np5l8z4 with your workspace ID. HTTP shows the signed request on the wire. The aws CLI and the SDKs sign for you. The CLI uses the graphon profile, and the SDK samples read GRAPHON_API_KEY.

Response

204

Storage deleted the object, or added a delete marker.

HTTP/1.1 204 No Content
x-amz-version-id: ver_1a2b3c4d5e6f47a8b9c0d1e2f3a4b5c6
x-amz-delete-marker: true
x-amz-request-id: 4F8A2C7D1E6B4093A5C2D8E1F7B3A960

Path parameters

bucketstringrequired

The bucket name.

keystringrequired

The object key. Keep each / as it is. Percent-encode the other reserved characters.

Query parameters

versionIdstringoptional

Remove this version for good.

Headers

x-amz-expected-bucket-ownerstringoptional

The workspace ID that must own the bucket. Another owner returns 403 AccessDenied.

Responses

204No Content

Storage deleted the object, or added a delete marker.

Response headers

x-amz-version-idstring

The version that the delete removed or created.

x-amz-delete-markerboolean

true when the delete added a delete marker.

This response has no body.

Errors

Select an error in the response example to see its XML body. Any request can also get the common errors, such as SignatureDoesNotMatch.

404NoSuchKey

The bucket has no object at this key, or no version with this versionId.

What to do: Check the key and the versionId.

404NoSuchBucket

No bucket has this name, or the bucket was deleted.

What to do: Check the bucket name. ListBuckets shows the buckets of the workspace.

403AccessDenied

The key does not have the Editor role, or the version is under object lock retention.

What to do: Use an Editor key. A retained version stays until its retain-until date.

Was this page helpful?