Delete User

Permanently remove a single tenant user by userId.

On success, the API reports how many users and related memberships were deleted. Use this for one-off removals from an admin detail view; prefer Bulk Delete Users when removing many accounts at once.

Use Delete User when:

• An admin removes one user from the tenant workspace.
• You need to clean up a test or inactive account by its _id.
• A confirmation dialog already collected a single target user id.
• You want a deletion summary that includes related membership cleanup counts.

When deletion succeeds, the API returns counts for users and related members removed.

1{2  "success": true,3  "message": "User deleted successfully",4  "data": {5    "usersDeleted": 1,6    "membersDeleted": 47  },8  "error": null9}

HTTP 200 OK means the user was deleted. Deletion fails when the user does not exist or the request is not authenticated.

1{2  "success": false,3  "message": "User not found",4  "data": null,5  "error": "User not found"6}

• Confirm the target user in the UI before calling delete - this action is permanent.
• Handle 404 Not Found gracefully if the user was already removed.
• Refresh List Users after a successful delete so the directory stays accurate.
• Use Bulk Delete Users instead when removing more than one account in a single operation.