Remove user from user group

DELETE 
/groups-srv/usergroups/:groupId/users/:sub

This API call removes the user from the user group by deleting the user group map.

Operation Behavior:

• Permanently removes the user's membership in the specified group
• All roles assigned to the user in this group are also removed
• The user's membership history is preserved in audit logs

Validation Rules:

• groupId: Must exist and be accessible
• sub: Must be a valid user ID (UUID format)
• The user group map must exist (user must be a member of the group)

Business Rules:

• Removing a user from a group also removes all their roles in that group
• This operation cannot be undone - the user will need to be re-added to regain access
• If the user is a member of subgroups, those memberships are not affected
• System-managed group memberships may have additional restrictions

Request

Responses

200

OK - User successfully removed from the user group

401

Unauthorized - Authentication failed or missing required scope

404

Not Found - User group map not found (user is not a member of the specified group)