DeleteObjectTagging - Amazon Simple Storage Service


Removes the entire tag set from the specified object. For more information about managing object tags, see Object Tagging.

To use this operation, you must have permission to perform the s3:DeleteObjectTagging action.

To delete tags of a specific object version, add the versionId query parameter in the request. You will need permission for the s3:DeleteObjectVersionTagging action.

The following operations are related to DeleteBucketMetricsConfiguration:

Request Syntax

DELETE /{Key+}?tagging&versionId=VersionId HTTP/1.1 Host: x-amz-expected-bucket-owner: ExpectedBucketOwner

URI Request Parameters

The request uses the following URI parameters.


The bucket name containing the objects from which to remove the tags.

When using this API with an access point, you must direct requests to the access point hostname. The access point hostname takes the form When using this operation using an access point through the AWS SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using Access Points in the Amazon Simple Storage Service Developer Guide.

Required: Yes


Name of the object key.

Length Constraints: Minimum length of 1.

Required: Yes


The versionId of the object that the tag-set will be removed from.


The account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 204 x-amz-version-id: VersionId

Response Elements

If the action is successful, the service sends back an HTTP 204 response.

The response returns the following HTTP headers.


The versionId of the object the tag-set was removed from.


Sample Request

The following DELETE request deletes the tag set from the specified object.

DELETE /exampleobject?tagging HTTP/1.1 Host: examplebucket.s3.<Region> Date: Wed, 25 Nov 2016 12:00:00 GMT Authorization: signatureValue

Sample Response

The following successful response shows Amazon S3 returning a 204 No Content response. The tag set for the object has been removed.

HTTP/1.1 204 No Content Date: Wed, 25 Nov 2016 12:00:00 GMT Connection: close Server: AmazonS3

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: