Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Delete Secret

DELETE /v1/secrets/:id
Permanently deletes a secret and all of its environment-specific values.

​
Path Parameters

ParameterTypeDescription
iduuidThe secret ID

​
Response

{
  "data": { "deleted": true },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}

​
Errors

StatusTypeDescription
404not_foundSecret not found
409in_useSecret is currently assigned to one or more routes
You cannot delete a secret that is in use by a route. Remove the secret from all routes first, then delete it.