Delete secret API Reference

DELETE

/tenants/{tenant}/secrets/{name}

const url = 'https://api.kupe.cloud/api/v1/tenants/acme/secrets/old-credentials';
const options = {method: 'DELETE', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.kupe.cloud/api/v1/tenants/acme/secrets/old-credentials \
  --header 'Authorization: <Authorization>'

Deleting a secret removes its definition and its copies from every target cluster namespace. Each target shows Withdrawing until the platform removes the source of its copy. The cluster copy is then removed, normally within seconds, later if the cluster is down. The values stay in Vault at secretPath; deleting them is the separate permanent delete, DELETE /vault/{path}.

Authorizations

BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

name

required

string

Secret name

Responses

204

Secret deleted

400

Invalid name

object

code

string

error

string

field

string

message

string

severity

string

401

Missing or invalid authentication

object

code

string

error

string

field

string

message

string

severity

string

403

Admin access required

object

code

string

error

string

field

string

message

string

severity

string

404

Secret not found

object

code

string

error

string

field

string

message

string

severity

string

429

Rate limit exceeded

object

code

string

error

string

field

string

message

string

severity

string