Set Bucket Tags

Replace the tags on a bucket you own.
EndpointMethodAdmin Required
/api/v1/buckets/:bucketName/tagsPUTNo

Sets the tags for a bucket you own, overwriting any existing tags entirely - this does not merge with the current tag-set. Matches the S3-compatible API's PutBucketTagging semantics.

Path Parameters

bucketName
string required
The name of the bucket.

Request Body

tags
object required
A flat key-value map of tags. Send an empty object to clear all tags (equivalent to Delete Bucket Tags).

Example

{
    "tags": {
        "env": "prod",
        "team": "storage"
    }
}

Response

Returns the saved tags:

{
    "tags": {
        "env": "prod",
        "team": "storage"
    }
}

Errors

StatusReason
400Missing bucket name
404Bucket not found (or not owned by you)

List Buckets

Retrieve your own buckets with pagination.

Delete Bucket Tags

Remove all tags from a bucket you own.