Reference data API - GET user permissions

Lists all possible user permissions that you can use.

The request produces an application/json payload.

GET	`https://api.dynatrace.com/ref/v1/account/permissions`

Authentication

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

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

Code	Type	Description
200	PermissionDto[]	Success. The response contains the list of permissions.

Response body objects

The `ResponseBody` object

The object doesn't provide any parameters.

The `PermissionDto` object

Element	Type	Description
id	string	The ID of the permission.
description	string	The display name of the permission.

Response body JSON model

json
[
  {
    "id": "string",
    "description": "string"
  }
]

Example

In this example, the request lists all permissions that are available in the account with the UUID of 9ad20784-76c6-4167-bfba-9b0d8d72a71d. The result is truncated to three entries.

Curl

bash
curl --request GET \
  --url https://api.dynatrace.com/ref/v1/account/permissions \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

plaintext
https://api.dynatrace.com/ref/v1/account/permissions

Response body

json
[
  {
    "id": "account-user-management",
    "description": "Manage users"
  },
  {
    "id": "tenant-manage-settings",
    "description": "Change monitoring settings"
  },
  {
    "id": "tenant-view-sensitive-request-data",
    "description": "View sensitive request data"
  }
]

Response code

200