Try it free

Resolve your effective settings permissions

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Get the effective Dynatrace settings permissions of the calling user in the environment with the Settings API by resolving the permissions you list.

POSTSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/settings/v1/effective-permissions:resolve

Overview

You use this operation to check which settings permissions you have in the environment. The permissions field of the request body lists the permissions to resolve, and a 200 response returns whether each of them is granted to you. Typical usage is checking access in an app before you show or enable settings actions.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
bodyResolutionRequest

The JSON body of the request. Contains the permissions to be resolved.

bodyRequired

Request body objects

The ResolutionRequest object

ElementTypeDescriptionRequired
permissionsSinglePermissionRequest[]-Required

The SinglePermissionRequest object

optional generic set of context data

ElementTypeDescriptionRequired
permissionstring-
The element can hold these values
  • settings:objects:read
  • settings:objects:write
  • settings:objects:admin
Required
contextPermissionContext-Optional

The PermissionContext object

ElementTypeDescriptionRequired
schemaIdstring-Required
scopestring-Required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
"permissions": [
{
"permission": "settings:objects:read",
"context": {
"schemaId": "string",
"scope": "string"
}
}
]
}

Response

Response codes

CodeDescription
200-
400-
403-
429-
503-
4XX-
5XX-
Related tags
Platform APIDynatrace Platform