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.
| PUT | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/settings/v1/objects/{object-id}/permissions/{accessor-type}/{accessor-id} |
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.
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| object-id | string | The ID of the required settings object | path | Required |
| accessor-type | string | The type of the accessor The element can hold these values
| path | Required |
| accessor-id | string | The user uuid or group uuid of the accessor, depending on the type | path | Required |
| admin-access | boolean | 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 | query | Optional |
| body | Update | The JSON body of the request. Contains the accessor and their new permissions. | body | Required |
UpdatePermissionsRequest object| Element | Type | Description | Required |
|---|---|---|---|
| permissions | Permissions | Permissions granted to the accessor on this object. The element can hold these values
| Required |
PermissionsList objectPermissions 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.
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"]}
| Code | Description |
|---|---|
| 200 | Success. |
| 400 | - |
| 404 | - |
| 429 | - |
| 503 | - |
| 4XX | - |
| 5XX | - |