Set Object Tags
Replace the tags on an object.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/objects/tags | PUT | No |
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
| Status | Reason |
|---|---|
400 | Missing bucket or key parameter, or more than 10 tags |
404 | Bucket not found (or not owned by you), or object not found |