Skip to main content
DELETE
/
secrets
/
{secret_id}
Delete an existing secret entry in the DB. This will also delete the associated secret in the cloud provider's secret manager.
curl --request DELETE \
  --url https://api.example.com/secrets/{secret_id}/ \
  --header 'Authorization: Bearer <token>'
{
  "status": "<string>",
  "error": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Api-key
string | null

Path Parameters

​
secret_id
string<uuid>
required

Response

The status of the operation.

A standard reply for many of our calls which has a 'status' ('success/failure') field and an 'error' field for failures.

Attributes:

  • status: The status of the operation. Always one of 'success' or 'failure'.
  • error: The error message, if any. Empty string if none.
​
status
string
required

The status of the operation. Always one of 'success' or 'failure'.

Examples:

"success"

""

​
error
string
required

The error message, if any. Empty string if none.

Examples:

""

"Permission denied"