Skip to main content
DELETE
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
volume_version
string
required

Body

application/json
expected_sequence
integer | null

Revision the volume is expected to be at. When set, the delete fails with a conflict if the volume has changed since, so a read followed by a delete cannot act on a version a tag has since been moved off. Take the value from volume_sequence.

Response

200 - application/json
namespace
string
required

Namespace the volume belongs to, in lowercase.

volume
string
required

Name of the volume, in lowercase.

version_ref
string
required

Full address of the deleted version, as bdn:<namespace>/<volume>@<digest>.

digest
string
required

Content digest of the deleted version, as b3:<hex>.

lifecycle
string
required

Lifecycle state of the version after the delete.

delete_after
string<date-time>
required

When the version stops being restorable, in ISO 8601 format. Until then it can be returned to service.

volume_sequence
integer
required

Revision of the volume after the delete.