Assign users to role
Assigns one or more users to a role.
This topic includes the following sections:
For a video demonstration of how to use this call, see Local-user-and-role-management-API.
Request
HTTP method: POST
URL: https://<hostname>:<port>/rsso/config/local/role/assignusers
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 | Name of the role | User-provided value Existing user-defined value | NA |
loginNames | String array | Yes | Login names of one or more users | User-provided value Existing user-defined value | NA |
Example request JSON
"roleName":"aRole",
"loginNames":["assignrole1", "assignrole2"]
}
Response
If successful, this method assigns the specified users to 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 Indicates one of the following:
|
401 |
| Unauthorized |
Related topics