# Deep Security Manager REST API

## Path: / rest / administrator-roles / {roleID} / rights

Update an administrator role with an additional set of rights.

Any pre-existing rights for the role will be retained and augmented by the rights specified by the request.

You can use the `#listRoles(String)` and `IAdministratorRoleAPI.describeRole(String, Integer)` APIs to find the "Full Access" role and retrieve a full list of supported right IDs.

Path parameters:
  roleID - the role ID.

Resources
Name | Description
--- | ---
{rightID} | Remove a right from an administrator role.

Method Summary
Resource | Description
--- | ---
`PUT /rest/administrator-roles/{roleID}/rights` | Update an administrator role with a new (complete) set of rights.
`POST /rest/administrator-roles/{roleID}/rights` | Update an administrator role with an additional set of rights.

Method Detail
Update an administrator role with a new (complete) set of rights. Any pre-existing rights for the role will be replaced by the rights specified in the request. You can use the {@link #listRoles(String)} and {@link #describeRole(String, Integer)} APIs to find the "Full Access" role and retrieve a full list of supported right IDs. Input: `ModifyAdministratorRoleRightsRequest` - an {@link ModifyAdministratorRoleRightsRequest} with the new rights for the administrator role. Output: `ModifyAdministratorRoleResponse` - a {@link ModifyAdministratorRoleResponse} with the modified details of the administrator role. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 403 - if the user is not authorized to modify administrator roles 404 - if the user is authorized to modify administrator roles but the administrator role does not exist or if the user is not authorized to modify the requested administrator role
Update an administrator role with an additional set of rights. Any pre-existing rights for the role will be retained and augmented by the rights specified by the request. You can use the {@link #listRoles(String)} and {@link #describeRole(String, Integer)} APIs to find the "Full Access" role and retrieve a full list of supported right IDs. Input: `AddAdministratorRoleRightsRequest` - an {@link AddAdministratorRoleRightsRequest} with the new rights to add to the administrator role. Output: `ModifyAdministratorRoleResponse` - a {@link ModifyAdministratorRoleResponse} with the modified details of the administrator role. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 403 - if the user is not authorized to modify administrator roles 404 - if the user is authorized to modify administrator roles but the administrator role does not exist or if the user is not authorized to modify the requested administrator role

Copyright © 2017 Trend Micro Inc. All Rights Reserved.