#Delete a Credential

Remove a credential from a wallet. The operation supports two modes:

Soft-delete (default) — The credential is marked as deleted and hidden from the wallet view but remains in the database and can be restored.
Permanent delete — The credential is irreversibly removed from the database.

To delete a credential, you first need its id. See List Credentials for how to retrieve it.

#Delete a Credential

CURL

Endpoint: DELETE /wallet-api/wallet/{walletId}/credentials/{credentialId} | API Reference

#Example Request

curl -X 'DELETE' \
  'http://0.0.0.0:7001/wallet-api/wallet/{walletId}/credentials/{credentialId}' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {token}'

Path Parameters

walletId: String - The ID of the wallet containing the credential. See Accounts & Wallets for how to retrieve it.
credentialId: String - The id of the credential to delete (e.g. urn:uuid:c2f7e988-a4cb-48c2-bbf6-ed97f6010abe). See List Credentials for how to retrieve it.

Query Parameters

permanent: Boolean (optional) - Set to true to permanently remove the credential. If omitted or false, a soft-delete is performed.

Header Parameters

Authorization: String - Bearer token obtained from the login endpoint. Format: Bearer {token}.

#Example Response

On success, the API returns 202 Accepted with no response body.

Status	Description
`202`	Credential deleted successfully
`400`	Credential could not be deleted (e.g. not found)

Permanent deletion example:

curl -X 'DELETE' \
  'http://0.0.0.0:7001/wallet-api/wallet/{walletId}/credentials/{credentialId}?permanent=true' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {token}'

Permanent deletion cannot be undone. Use soft-delete when you want to keep the option to restore the credential.

Last updated on April 29, 2026

View a Credential Import a Credential