Delete User

DELETE /api/users/{user_id}

Delete User

cURL

curl --request DELETE \
  --url https://api.example.com/api/users/{user_id}

200

{
  "success": true
}

Deletes a user account and all associated data including chats and group memberships.

Authentication

Requires admin authentication.

Path Parameters

user_id · string · required

The unique identifier of the user to delete

Response

Returns a boolean indicating success.

success · boolean

true if user was successfully deleted, error otherwise

Example Request

curl -X DELETE "https://your-domain.com/api/users/user-123" \
  -H "Authorization: Bearer YOUR_TOKEN"

Example Response

true

Errors

• 403 - Cannot delete yourself
• 403 - Cannot delete the primary admin user (first user created)
• 500 - Error occurred during user deletion

Notes

• Deletion is permanent and cannot be undone
• Deletes all associated data:
  • User authentication records
  • All user chats
  • Group memberships (removed from all groups)
• Primary admin user (first user created) cannot be deleted for system integrity
• Users cannot delete themselves
• Operation is atomic - if chat deletion fails, user deletion is aborted