User management API - PUT user groups
Sets groups membership of a user. Any existing memberships are overwritten.
The request consumes an
To execute this request, you need the Allow write access for identity resources (users and groups) (
account-idm-write) scope assigned to your token. To learn how to obtain and use it, see Authentication.
The ID of the required account.
You can find the UUID on the Account > Account management API page, during creation of an OAuth client.
The email address of the required user.
The body of the request. Contains a list of groups (specified by UUIDs) where the user is to be a member.
The user will be removed from any group that is not specified here.
Request body objects
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
Success. The group membership has been set. Response doesn't have a body.
In this example, the request assigned the user with the firstname.lastname@example.org email address to groups with the following UUIDs:
The response code of 200 indicates that the modification has been successful.
1curl --request PUT \2 --url 'https://email@example.com' \3 --header 'Authorization: Bearer abcdefjhij1234567890' \4 --header 'Content-Type: application/json' \5 --data '6 [7 "b794097-8ad2-4b32-b923-0131da2eeddf",8 "56d56aba-c12f-44c1-a0ba-42eba3e3ff84"9 ]10'
1[2 "b794097-8ad2-4b32-b923-0131da2eeddf",3 "56d56aba-c12f-44c1-a0ba-42eba3e3ff84"4]