List Versions

List all versions of a specific object.
EndpointMethodAdmin Required
/api/v1/objects/versionsGETNo

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

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

Delete Object

Delete an object or folder from a bucket.

Delete Version

Permanently delete a specific version of an object.