Removes a user from groups.
The request consumes an application/json
payload.
DELETE |
|
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 OAuth clients.
Parameter | Type | Description | In | Required |
---|---|---|---|---|
accountUuid | string | The ID of the required account. You can find the UUID on the Account Management > Identity & access management > OAuth clients page, during creation of an OAuth client. | path | required |
string | The email address of the required user. | path | required | |
group-uuid | string[] | A list of groups the user is no longer a member of. To specify several groups, use the following format: | query | required |
Code | Description |
---|---|
200 | Success. The user has been removed from groups. Response doesn't have a body. |
In this example, the request removes the user with the john.smith@company.com email address from groups with the following UUIDs:
The response code of 200 indicates that the deletion has been successful.
curl --request DELETE \--url 'https://api.dynatrace.com/iam/v1/accounts/9ad20784-76c6-4167-bfba-9b0d8d72a71d/users/john.smith@company.com/groups?group-uuid=b794097-8ad2-4b32-b923-0131da2eeddf&group-uuid=56d56aba-c12f-44c1-a0ba-42eba3e3ff84' \--header 'Authorization: Bearer abcdefjhij1234567890'
https://api.dynatrace.com/iam/v1/accounts/9ad20784-76c6-4167-bfba-9b0d8d72a71d/users/john.smith@company.com/groups?group-uuid=b794097-8ad2-4b32-b923-0131da2eeddf&group-uuid=56d56aba-c12f-44c1-a0ba-42eba3e3ff84
200