Updates the permissions for the specified accessor on the specified settings object. Any user with read/write permissions on the object can update permissions. The accessor ID must be a user or group UUID; use the User management API or Group management API to look up these identifiers.
This endpoint applies only to objects on schemas with owner-based access control enabled (ownerBasedAccessControl: true). To identify such schemas, include ownerBasedAccessControl in the add-fields parameter when calling List schemas.
The request consumes and produces an application/json payload.
| PUT | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/v2/settings/objects/{objectId}/permissions/{accessorType}/{accessorId} |
| PUT | Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/v2/settings/objects/{objectId}/permissions/{accessorType}/{accessorId} |
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| objectId | string | The ID of the required settings object. | path | Required |
| accessorType | string | The type of the accessor. The element can hold these values
| path | Required |
| accessorId | string | The user uuid or group uuid of the accessor, depending on the type. | path | Required |
| adminAccess | 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. | body | Optional |
UpdatePermissionsRequest objectThe request to update the permissions of a specific accessor.
| Element | Type | Description | Required |
|---|---|---|---|
| permissions | string[] | r = read, w = write The element can hold these values
| Required |
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"]}
| Code | Type | Description |
|---|---|---|
| 200 | - | Success |
| 400 | Error | If permission list is empty, contains unsupported entries or unsupported combinations of entries. |
| 404 | Error | No object available for the given objectId or the accessor doesn't have any permissions on this object. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code |
| constraintViolations | Constraint | A list of constraint violations |
| message | string | The error message |
ConstraintViolation objectA list of constraint violations
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}