Skip to main content
DELETE
Delete secret
Deletes a secret permanently. There is no soft-delete or restore — once deleted, the secret is gone, including its credentials and audit history.
For ACB deployments updated from a version prior to 1.2, switch to the https://{hostname}/EkranACB server in the Playground.

Permissions required

The user owning the Access Token must have Owner role on the secret.

Errors

See Status codes. Common errors:
  • 403 Forbidden — user lacks Owner role.
  • 404 Not Found — secret doesn’t exist.
  • 409 Conflict — secret is currently checked out by another user.

Get secret

Verify before deletion.

Force check-in

Release a checked-out secret before deletion.

Delete folder

Delete the parent folder after removing all secrets.

API reference

Status codes.

Authorizations

Authorization
string
header
required

Access token for authentication

Path Parameters

id
integer<int32>
required

The ID of the secret to delete

Required range: x >= 1

Response

Secret deleted successfully