Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Path Parameters

volume_namespace
string
required
volume_name
string
required

Query Parameters

include_tombstoned
boolean
default:false

Whether to include deleted versions. A deleted version carries a TOMBSTONED lifecycle and stays restorable until its recovery deadline passes.

Response

200 - application/json

Every version of a volume, newest first.

Unpaginated: limit and cursor are absent rather than accepted and ignored, so adding them once the volume service pages this listing is a purely additive change.

versions
VolumeVersionV1 · object[]
required

Versions of the volume, newest first.

volume_sequence
integer
required

Revision of the volume as a whole when the versions were read. Pass it as expected_sequence on a later delete to make that delete conditional on the volume not having changed since. Distinct from the per-version sequence, which is the revision a version was committed at.