Edit local user


Edits a local user. The following user changes can be made: login name, user name, description, and enabled status.

This topic includes the following sections:

Request

HTTP method: POST

URL: https://<hostname>:<port>/rsso/config/local/user/edit

Header: For header information, such as required authentication token, see Remedy-SSO-administrator-Login-and-Logout-calls.

Request body properties

Property

Type

Required

Description

Values

Default value

loginName

String

Yes

Existing user login name

User-provided value

Existing user-defined value

 NA

newloginName

String

No

New user login name

User-provided value

NA

userName

String

No

Display name

User-provided value

Existing user-defined value

 NA

description

String

No

User description

User-provided value

Existing user-defined value

 NA

enabled

Boolean

No

User account status

User-provided value

Existing user-defined value

NA

Example request JSON

{
 "loginName":"aoadmin1",
 "newLoginName":"aoadmin2",
 "userName":"BMC Atrium Orchestrator",
 "description":"BMC Atrium Orchestrator",
 "enabled":"true"
}

Response

If successful, this method modifies the specified local user.

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 the user. Some causes are

  • All of the mandatory fields were not specified
  • User already exists

401

 

Unauthorized

 

Related topics

Format-of-API-examples

Create-local-user

Search-local-user

Update-local-user-password

Delete-local-user

 

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*