Get Object Tags
Get the tags attached to an object.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/objects/tags | GET | No |
Returns the tags attached to the current version of an object in a bucket you own. This is the same tag-set exposed by the S3-compatible API's GetObjectTagging (which also supports targeting a specific historical version via versionId - the internal API only ever operates on the current version).
Query Parameters
bucket
string required
Name of the bucket.
key
string required
Object key.
Response
{
"tags": {
"project": "alarik"
}
}
tags is an empty object if the object has never been tagged - this endpoint does not 404 for an untagged object, only for a missing one.
Errors
| Status | Reason |
|---|---|
400 | Missing bucket or key parameter |
404 | Bucket not found (or not owned by you), or object not found |