UNunkeyed
identities

Delete Identity

Changed on

Permanently delete an identity. This operation cannot be undone.

Use this for data cleanup, compliance requirements, or when removing entities from your system.

Important Requires identity.*.delete_identity permission Associated API keys remain functional but lose shared resources External ID becomes available for reuse immediately

post/v2/identities.deleteIdentity

Request

  • Base URL
    https://api.unkey.com
  • URL
    https://api.unkey.com/v2/identities.deleteIdentity
  • Auth
    HTTP bearer

Request body

identitystring required

The ID of the identity to delete. This can be either the externalId (from your own system that was used during identity creation) or the identityId (the internal ID returned by the identity service).

Example request

{
  "identity": "user_123"
}

Response

Identity successfully deleted

Example response

{
  "meta": {
    "requestId": "req_123"
  }
}

Changes