List visible groups for an organizational level

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List visible groups in Dynatrace for an organizational level with the IAM API, filtered by group UUIDs or partialGroupName and returned by your access rights.

Overview

It is required to provide at either request body containing list of group uuids or partialGroupName. If both are provided then the result returns groups meeting any of the provided criteria. Authorization is based on an assignment of the calling user to the account associated with the 'level-type' and 'level-id' For environment 'level-type' user has to be assigned to account to which the environment is assigned, user does not need any permissions in such environment

Authentication

To execute this request, you need a platform token or OAuth access token with iam:groups:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

[
  "string"
]

Response

{
  "results": [
    {
      "uuid": "string",
      "groupName": "string",
      "type": "LOCAL"
    }
  ],
  "nextPageKey": "string",
  "totalCount": 1
}

{
  "error": {
    "code": 1,
    "message": "string",
    "details": {
      "missingScopes": [
        "string"
      ],
      "constraintViolations": [
        {
          "path": "string",
          "message": "string",
          "parameterLocation": "string"
        }
      ]
    }
  }
}