Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/zitadel/zitadel/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

DELETE /v2/users/{user_id}

​
Description

The state of the user will be changed to ‘deleted’. The user will not be able to log in anymore. Endpoints requesting this user will return an error ‘User not found’.

​
Required Permission

  • authenticated

​
Path Parameters

​
user_id
string
required
The unique identifier of the user to delete.

​
Response

​
details
object
Metadata about the deletion.
​
sequence
string
Sequence number of the change.
​
changeDate
timestamp
Timestamp of when the user was deleted.
​
resourceOwner
string
Organization ID that owned the user.

​
Example Request

curl -X DELETE https://your-domain.zitadel.cloud/v2/users/d654e6ba-70a3-48ef-a95d-37c8d8a7901a \
  -H "Authorization: Bearer $TOKEN"

​
Example Response

{
  "details": {
    "sequence": "1236",
    "changeDate": "2024-03-15T12:00:00Z",
    "resourceOwner": "69629026806489455"
  }
}

​
Error Responses

  • 404 Not Found - User ID does not exist
  • 403 Forbidden - Insufficient permissions
  • 401 Unauthorized - Not authenticated

​
Important Notes

  • Deleting a user is permanent and cannot be undone
  • The user will immediately lose access to all applications
  • Consider using deactivation instead if you may need to restore access later
  • All user data, including authentication methods, will be marked as deleted