Edit role
Edits a role. The following role changes can be made: role name and description.
This topic includes the following sections:
Request
HTTP method: POST
URL: https://<hostname>:<port>/rsso/config/local/role/edit
Header: For header information, such as required authentication token, see Remedy-SSO-administrator-Login-and-Logout-calls.
Request body properties
Properties | Type | Required | Description | Values | Default value |
|---|---|---|---|---|---|
roleName | String | Yes | Existing role name | User -provided value Existing user-defined value | NA |
oldRoleName | String | No | Existing role name | User-provided value Existing user-defined value | NA |
newRoleName | String | No | New role name | User-provided value | NA |
description | String | No | New description | User-provided value | NA |
Example request JSON
"roleName":"Admin role"
"oldRoleName":""
"newRoleName":""
"description":""
}
Response
If successful, this method modifies the specified role.
Response body properties
Property | Description |
|---|---|
code | Status code (see Status codes and messages) |
msg | Status |
data | NA |
Example response JSON
"code": 200,
"msg": "OK",
"data": {}
}
Status codes and messages
For more details about HTTP response codes, see HTTP response codes.
HTTP code | Message (msg) | Description |
|---|---|---|
200 | OK | Request succeeded |
400 |
| Bad request An error occurred while adding role. Some causes are
|
401 |
| Unauthorized |
Related topics