Set Object Metadata
Update an object's Content-Type and custom metadata in place.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/objects/metadata | PUT | No |
Updates the Content-Type and custom (x-amz-meta-*) metadata of the current version of an object you own, overwriting the existing metadata entirely.
This is a metadata-only operation: the object's data is untouched, no new version is created (even in a versioning-enabled bucket), and - matching real S3's metadata/tagging semantics - it does not trigger a webhook notification, since nothing about the object's content changed.
Query Parameters
bucket
string required
Name of the bucket.
key
string required
Object key.
Request Body
contentType
string required
The object's MIME type. Cannot be empty.
metadata
object required
A flat key-value map of custom metadata. Keys are lowercased. Send an empty object to clear all custom metadata.
Example
{
"contentType": "image/png",
"metadata": {
"author": "julian"
}
}
Response
Returns the saved Content-Type and metadata:
{
"contentType": "image/png",
"metadata": {
"author": "julian"
}
}
Errors
| Status | Reason |
|---|---|
400 | Missing bucket/key parameter, or empty contentType |
404 | Bucket not found (or not owned by you), or object not found |