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

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 it cannot act on a volume someone else has pushed to. Take the value from a volume's sequence, or from volume_sequence.

Response

200 - application/json
namespace
string
required

Namespace the volume belongs to, in lowercase.

name
string
required

Name of the volume, in lowercase.

versions_deleted
integer
required

Number of versions this request deleted. Zero when the volume had no live versions left, which is not an error.

volume_sequence
integer
required

Revision of the volume after the delete.