API Reference
Delete a user
Delete a user by id. Admin only, with self-delete and last-admin guards.
DELETE
/auth/users/{user_id}adminRequires the admin role. You cannot delete your own user, and you cannot delete the last remaining admin — both return 400.
Path parameters
user_idintegerrequiredThe id of the user to delete.
Responses
200User deleted
json
{ "message": "user deleted" }400Self-delete or last-admin guard
json
{ "detail": "cannot delete the last admin user" }404No such user
json
{ "detail": "user not found" }