Add permissions for an accessor on a settings object

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Grant a user or group permissions on a Dynatrace settings object with the Settings API; anyone with write permission on the object can add them.

Overview

You use the object-id path parameter to choose a settings object and the accessor and permissions fields in the request body to grant permissions to one user or group. Anyone with write permission on the object can add permissions. With the admin-access query parameter set to true and the settings:objects:admin permission, you can act on objects you don't own.

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

{
  "accessor": {
    "type": "user",
    "id": "string"
  },
  "permissions": [
    "r",
    "w"
  ]
}

Response

{
  "accessor": {
    "type": "user",
    "id": "string"
  },
  "permissions": [
    "r",
    "w"
  ]
}