Delete a secret

POST 
/api/v1/secrets/delete

Deletes the stored value before its metadata. An absent secret is an idempotent success with deleted false, which may be omitted. A failure does not prove the previous value remains intact.

Known custom MCP references block deletion with 409 unless force is used. Detach or rebind those consumers first where possible. The reference list covers tracked custom servers, not every possible external consumer. Forced deletion can break future credential resolution; it does not recall cached or already dispatched use, revoke the credential at its issuer, or attest to backup erasure.

Request

Responses

200

Delete processed

Document ID: DOC-CP-secrets-api-deleteSecret. Section identities and revisions.

Section	Stable reference
Overview	DOC-CP-secrets-api-deleteSecret#overview
Request	DOC-CP-secrets-api-deleteSecret#request
Responses	DOC-CP-secrets-api-deleteSecret#responses