User management API - DELETE user from groups

Removes a user from groups.

The request consumes an application/json payload.

DELETE

https://api.dynatrace.com/iam/v1/accounts/{accountUuid}/users/{email}/groups

Authentication

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.

Parameters

Parameter Type Description In Required

accountUuid

string

Parameter	Type	Description	In	Required
accountUuid	string	The ID of the required account. You can find the UUID on the Account > Account management API page, during creation of an OAuth client.	path	required
email	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: `group-uuid=aaaaaa&group-uuid=bbbb`.	query	required

The ID of the required account.

You can find the UUID on the Account > Account management API 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: group-uuid=aaaaaa&group-uuid=bbbb.

query

required

Response

Response codes

Code	Description
200	Success. The user has been removed from groups. Response doesn't have a body.

Example

In this example, the request removes the user with the john.smith@company.com email address from groups with the following UUIDs:

b794097-8ad2-4b32-b923-0131da2eeddf
56d56aba-c12f-44c1-a0ba-42eba3e3ff84

The response code of 200 indicates that the deletion has been successful.

Curl

1curl --request DELETE \
2  --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' \
3  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

1https://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

Response code

200