Get the permissions that apply to all users on a Dynatrace settings object with the Settings API to check whether the object is shared environment-wide.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/settings/v1/objects/{object-id}/permissions/all-users |
You use the object-id path parameter to read the permissions of the all-users accessor on one settings object, which apply to every user in the environment. 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 all-users 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 | - | - |
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.
{"accessor": {"type": "user","id": "string"},"permissions": ["r","w"]}