Set Object Tags

Replace the tags on an object.
EndpointMethodAdmin Required
/api/v1/objects/tagsPUTNo

Sets the tags on the current version of an object in a bucket you own, overwriting any existing tags entirely. Modifies that version's metadata in place - it does not create a new object version, matching the S3-compatible API's PutObjectTagging semantics.

Query Parameters

bucket
string required
Name of the bucket.
key
string required
Object key.

Request Body

tags
object required
A flat key-value map of tags. Limited to 10 tags per object, matching real S3. Send an empty object to clear all tags (equivalent to Delete Object Tags).

Example

{
    "tags": {
        "project": "alarik"
    }
}

Response

Returns the saved tags:

{
    "tags": {
        "project": "alarik"
    }
}

Errors

StatusReason
400Missing bucket or key parameter, or more than 10 tags
404Bucket not found (or not owned by you), or object not found

Get Object Tags

Get the tags attached to an object.

Delete Object Tags

Remove all tags from an object.