Skip to main content
DELETE
/
api
/
credentials
/
{id}
Delete Credential
curl --request DELETE \
  --url https://api.example.com/api/credentials/{id}
{
  "deleted": true
}
Permanently deletes a credential from the encrypted vault.

​
Authentication

Requires a valid session token in the Authorization header: 
Authorization: Bearer <session_token>

​
Path Parameters

​
id
string
required
The credential UUID to delete

​
Response

​
Success Response

​
deleted
boolean
true if the credential was found and deleted
{
  "deleted": true
}

​
Not Found Response (404)

​
error
string
Error message
{
  "error": "credential not found"
}

​
Error Responses

​
Status Codes

  • 200 - Successfully deleted
  • 401 - Unauthorized (missing or invalid session token)
  • 404 - Credential with the given ID does not exist
  • 500 - Internal server error (database failure)

​
Examples

curl -X DELETE https://localhost:3978/api/credentials/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer fn_sess_abc123..."

​
Security Notes

  • Deletion is permanent and cannot be undone
  • The encrypted key material is securely removed from the database
  • If the credential is currently in use by active proxy requests, those requests will fail after deletion

Build docs developers (and LLMs) love

Get started for freeTalk to us