Delete a Vault entry permanently API Reference

DELETE

/tenants/{tenant}/vault/{path}

curl --request DELETE \
  --url https://api.kupe.cloud/api/v1/tenants/example/vault/example \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --header 'If-Match: example' \
  --data '{ "confirm": "example" }'

Permanently remove every version of the values, after you confirm the path and no secret uses it. The version is checked before the purge, not at the same instant, so a write that lands in between is removed too.

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

path

required

string

Path in the tenant’s vault

Header Parameters

If-Match

required

string

KV version from the entry’s ETag

Request Body

Confirm the exact path

Media type application/json

object

confirm

string

Example ^generated

{
  "confirm": "example"
}

Responses

204

Entry permanently deleted

400

Bad Request

object

code

string

error

string

field

string

message

string

severity

string

401

Unauthorized

object

code

string

error

string

field

string

message

string

severity

string

403

Forbidden

object

code

string

error

string

field

string

message

string

severity

string

404

Not Found

object

code

string

error

string

field

string

message

string

severity

string

409

Conflict

object

code

string

error

string

field

string

message

string

severity

string

412

Precondition Failed

object

code

string

error

string

field

string

message

string

severity

string

428

Precondition Required

object

code

string

error

string

field

string

message

string

severity

string

429

Too Many Requests

object

code

string

error

string

field

string

message

string

severity

string

503

Service Unavailable

object

code

string

error

string

field

string

message

string

severity

string