Identities

Delete identity

Delete an identity from your ledger.

DEL/identities/{identity_id}

Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>.

Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.

Path

identity_idstringrequiredpath

Id of the identity to delete.

Response

messagestringrequired

Confirms the identity was deleted.

curl -X DELETE "http://localhost:5001/identities/{identity_id}" \
  -H "X-blnk-key: <api-key>"

{
  "message": "Identity deleted successfully"
}

{
  "error": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found",
  "error_detail": {
    "code": "IDT_NOT_FOUND",
    "message": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found"
  }
}