Skip to main content

​
POST /v2/identities.deleteIdentity

Permanently delete an identity. This operation cannot be undone. Use this for data cleanup, compliance requirements, or when removing entities from your system. Important:
  • Associated API keys remain functional but lose shared resources
  • External ID becomes available for reuse immediately

​
Required Permissions

Requires identity.*.delete_identity permission

​
Request

​
string
required
The ID of the identity to delete. Accepts either the externalId or the identityId.Example: user_123

​
Response

Returns an empty data object on successful deletion.

​
Example

cURL
Response

​
Error Codes

  • 400 - Bad request (invalid parameters)
  • 401 - Unauthorized (missing or invalid root key)
  • 403 - Forbidden (insufficient permissions - requires identity.*.delete_identity)
  • 404 - Not found (identity with the specified externalId doesn’t exist)
  • 429 - Too many requests (rate limit exceeded)
  • 500 - Internal server error