Try it free

Update the permissions of an accessor on a settings object

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Update the permissions an existing user or group has on a Dynatrace settings object with the Settings API; write permission on the object is required.

PUTSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/settings/v1/objects/{object-id}/permissions/{accessor-type}/{accessor-id}

Overview

You use the object-id, accessor-type, and accessor-id path parameters to choose one accessor on a settings object and send its new permissions in the request body. The accessor ID is the user UUID or group UUID, depending on the accessor type. Anyone with write permission on the object can update permissions.

Authentication

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

Parameters

ParameterTypeDescriptionInRequired
object-idstring

The ID of the required settings object

pathRequired
accessor-typestring

The type of the accessor

The element can hold these values
  • user
  • group
pathRequired
accessor-idstring

The user uuid or group uuid of the accessor, depending on the type

pathRequired
admin-accessboolean

If set to true and user has settings:objects:admin permission, the endpoint will act as if the user is the owner of all objects

queryOptional
bodyUpdatePermissionsRequest

The JSON body of the request. Contains the accessor and their new permissions.

bodyRequired

Request body objects

The UpdatePermissionsRequest object

ElementTypeDescriptionRequired
permissionsPermissionsList[]

Permissions granted to the accessor on this object. r grants read access to view the object; w grants write access to modify the object. Valid values: ["r"] for read-only, ["r", "w"] for read and write.

The element can hold these values
  • r
  • w
Required

The PermissionsList object

Permissions granted to the accessor on this object. r grants read access to view the object; w grants write access to modify the object. Valid values: ["r"] for read-only, ["r", "w"] for read and write.

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": [
"r",
"w"
]
}

Response

Response codes

CodeDescription
200

Success.

400-
404-
429-
503-
4XX-
5XX-
Related tags
Platform APIDynatrace Platform