Object Tagging With the Wasabi S3 API

  • Updated on Feb 13, 2025
  • Published on May 29, 2024
  • 1 minute(s) read
Prev Next

GET Object Tagging

Wasabi supports functionality to fetch the tag set of an object when the object:

  • Does not have any tags

  • Does have tags

When the Object Does Not Have Any Tags

GET https://s3.wasabisys.com/my_bucket/Test-object1.txt?tagging

Response body:

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
   <TagSet></TagSet>
</Tagging>
Status 200 OK

When the Object Has Tags

GET https://s3.wasabisys.com/my_bucket/Test-object2.pdf?tagging

Response body:

<!--?xml version="1.0" encoding="UTF-8"?-->
<Tagging>
   <TagSet>
      <Tag>
         <Key>key2</Key>
         <Value>value2</Value>
      </Tag>
      <Tag>
         <Key>key1</Key>
         <Value>value1</Value>
      </Tag>
   </TagSet>
</Tagging>
Status 200 OK

PUT Object Tagging

Wasabi supports functionality for:

  • Adding the tag value of an existing object in a bucket

  • Appending the tag value of an existing object in a bucket

Adding the Tag Value of an Existing Object in a Bucket

PUT https://s3.wasabisys.com/my_bucket/Test-object3.pdf?tagging

Content-Type: text/xml

Response body:

<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <TagSet>
      <Tag>
         <Key>tag1</Key>
         <Value>value1</Value>
      </Tag>
   </TagSet>
</Tagging>
Status 200 OK

Appending the Tag Value of an Existing Object in a Bucket

In this example, an existing object already has the tag value of “key5” –“value5”, You can append a new tag pairs along with the existing pair.

PUT https://s3.wasabisys.com/my_bucket/Test-object4.jpg?tagging

Content-Type: text/xml

Response body:

<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <TagSet>
      <Tag>
         <Key>key5</Key>
         <Value>value5</Value>
      </Tag>
      <Tag>
         <Key>key6</Key>
         <Value>value6</Value>
      </Tag>
   </TagSet>
</Tagging>
Status 200 OK

To PUT tags of any other version, use the versionId query parameter.

DELETE Object Tagging

This removes the entire tag set from the specified object. 

DELETE https://s3.wasabisys.com/my_bucket/Test-object5.pdf?tagging

Response body:

<empty>
Status 204 No Content

To delete tags of any other version, use the versionId query parameter.