Skip to main content
DELETE/vault/secrets/{path}

Delete Secret

Revokes a secret at once: it can no longer be read or revealed.

Its key material is destroyed when the retention window ends.

Only the owner can delete a secret.

Parameters
projectId *query

The project's id.

path *path

The secret's path: /-delimited segments, such as database/prod/password.

Responses
HTTPK9O CodeDescription
204The secret is revoked.
401The request carries no authenticated caller.
403The caller can see the secret but doesn't own it.
404No such secret visible to the caller.
500An internal error. Retry later.
TypeScript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.kibo.vault.secrets.delete('<name>')

Showing example in TypeScript

More in Secrets