Group management API - GET group members

Lists all members of a user group.

The request produces an application/json payload.

GET

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

Authentication

To execute this request, you need the Allow read access for identity resources (users and groups) (account-idm-read) scope assigned to your token. To learn how to obtain and use it, see Authentication.

Parameters

ParameterTypeDescriptionInRequired
accountUuidstring

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.

pathrequired
groupUuidstring

The UUID of the required user group.

pathrequired

Response

Response codes

CodeTypeDescription
200GroupUserListDto

Success. The response contains members of the group.

Response body objects

The GroupUserListDto object

ElementTypeDescription
countnumber

The number of entries in the list.

itemsUserDto[]-

The UserDto object

ElementTypeDescription
uidstring

The UUID of the user.

emailstring

The email address of the user.

namestring

The first name of the user.

surnamestring

The last name of the user.

userStatusstring

The status of this user in Dynatrace:

  • ACTIVE: The user is active.
  • INACTIVE: The user is deactivated and cannot sign in to Dynatrace.
  • PENDING: The user received an invitation, but hasn't completed sign-up yet.
  • DELETED: The user was deleted and cannot sign in to Dynatrace anymore.
  • ECUSTOMS_MANUALLY_BLOCKED: The user is blocked due to to a trade and export compliance violation.
  • ACTIVE
  • INACTIVE
  • PENDING
  • DELETED
  • ECUSTOMS_MANUALLY_BLOCKED
emergencyContactboolean

The user is (true) or is not (false) an emergency contact for the account.

Response body JSON model

{
"count": 1,
"items": [
{
"uid": "string",
"email": "string",
"name": "string",
"surname": "string",
"userStatus": "ACTIVE",
"emergencyContact": true
}
]
}

Example

In this example, the request lists the members of the user group with the UUID of 7a1d224d-0ebc-4318-ab1e-64b217b7c156. The example result is truncated to three entries.

Curl

curl --request GET \
--url 'https://api.dynatrace.com/iam/v1/accounts/9ad20784-76c6-4167-bfba-9b0d8d72a71d/groups/7a1d224d-0ebc-4318-ab1e-64b217b7c156/users' \
--header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

https://api.dynatrace.com/iam/v1/accounts/9ad20784-76c6-4167-bfba-9b0d8d72a71d/groups/7a1d224d-0ebc-4318-ab1e-64b217b7c156/users

Response body

{
"count": 10,
"items": [
{
"uid": "20cc1c46-870e-48ca-ac40-9a8459cf6632",
"email": "Jane.brown@company.com",
"name": "Jane",
"surname": "Brown",
"emergencyContact": false,
"userStatus": "ACTIVE"
},
{
"uid": "08dfae05-3bb9-4389-8c34-2ac0020c08b1",
"email": "john.smith@company.com",
"name": "John",
"surname": "Smith",
"emergencyContact": true,
"userStatus": "ACTIVE"
},
{
"uid": "d48faa11-a488-47c4-b56d-c7acd0e76ea1",
"email": "james.johnson@company.com",
"name": "James",
"surname": "Johnson",
"emergencyContact": false,
"userStatus": "ACTIVE"
}
]
}

Response code

200