Unassign existing groups (optionally leave them)

[ambrazasp]

Before this - if you call POST /users or PATCH /users/:id groups used to be removed (those which were not passed).

After this change, you can pass unassignExistingGroups: false as parameter to leave old groups in place.

Example:
Before: If you call groups: [{id: 1, role: 'USER'}] - if user existed in group with ID 2, user is removed from that group, leaving user only in group 1.

After: If you call groups: [{id: 1, role: 'USER'}], unassignExistingGroups: false - if user existed in any other group - he/she will be left in that group without removing (unassigning)

However, keep in mind, that before this change user was removed only from visible groups (for that specific user). This change only works as toggle only. This means - if user was in group 1, group 2, group 3 (updating/creating without unassignExistingGroups parameter) if "admin" that can make changes to that user only sees group 1 and group 2, user was not removed from group 3 (it's not visible for them).

✅ Tests (4) for invite and update were written to test this parameter