List Versions
List all versions of a specific object.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/objects/versions | GET | No |
Returns all versions of a specific object, including delete markers. Only works on buckets where versioning has been enabled at some point.
Query Parameters
bucket
string required
Name of the bucket.
key
string required
Object key to list versions for.
Response
[
{
"key": "report.pdf",
"size": 245678,
"contentType": "application/pdf",
"etag": "d41d8cd98f00b204e9800998ecf8427e",
"lastModified": "2025-01-15T10:30:00Z",
"isFolder": false,
"versionId": "def456ghi789",
"isLatest": true,
"isDeleteMarker": false
},
{
"key": "report.pdf",
"size": 0,
"contentType": "",
"etag": "",
"lastModified": "2025-01-14T15:00:00Z",
"isFolder": false,
"versionId": "abc123def456",
"isLatest": false,
"isDeleteMarker": true
},
{
"key": "report.pdf",
"size": 198432,
"contentType": "application/pdf",
"etag": "098f6bcd4621d373cade4e832627b4f6",
"lastModified": "2025-01-13T09:15:00Z",
"isFolder": false,
"versionId": "xyz789abc012",
"isLatest": false,
"isDeleteMarker": false
}
]
Response Fields
versionId
string
Unique identifier for this version.
isLatest
boolean
Whether this is the current (latest) version.
isDeleteMarker
boolean
Whether this version is a delete marker (indicates the object was deleted).
Errors
| Status | Reason |
|---|---|
400 | Missing bucket or key parameter |
404 | Bucket not found (or not owned by you) |