List the current permissions on a Dynatrace settings object with the Settings API to see which users and groups can read or change it.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/settings/v1/objects/{object-id}/permissions |
You use the object-id path parameter to read all current permissions on one settings object, including those of individual accessors such as users and groups. With the admin-access query parameter set to true and the settings:objects:admin permission, you can act on objects you don't own. A 200 response returns the permissions.
To execute this request, you need a platform token or OAuth access token with settings:objects:read 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 |
| 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 |
| Code | Type | Description |
|---|---|---|
| 200 | Accessor | Success. |
| 404 | - | - |
| 429 | - | - |
| 503 | - | - |
| 4XX | - | - |
| 5XX | - | - |
AccessorPermissionsList object| Element | Type | Description |
|---|---|---|
| accessors | Accessor | - |
AccessorPermissions object| Element | Type | Description |
|---|---|---|
| accessor | Identity | - |
| permissions | Permissions | Permissions granted to the accessor on this object. The element can hold these values
|
Identity object| Element | Type | Description |
|---|---|---|
| type | string | -The element can hold these values
|
| id | string | user id or user group id if type is 'user' or 'group', missing if type is 'all-users' |
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.
{"accessors": [{"accessor": {"type": "user","id": "string"},"permissions": ["r","w"]}]}