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_tag
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 delete a tag someone else has just set on another version. Take the value from volume_sequence.

Required range: x >= 0

Response

200 - application/json
namespace
string
required

Namespace the volume belongs to, in lowercase.

volume
string
required

Name of the volume, in lowercase.

tag
string
required

Tag name from the request, with its original capitalization.

deleted
boolean
required

Whether the tag existed and was deleted. False when the volume had no tag by that name, which is not an error.

volume_sequence
integer
required

Revision of the volume after the delete.