Delete local user


Deletes the specified local user.

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/user/delete

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

User login name

User-provided value

Existing user-defined value

NA

Example request JSON

{
 "loginName":"aLoginName"
}

Response

If successful, this method deletes 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 requestAn error occurred while adding role. Some causes are

  • All of the mandatory fields were not specified
  • No such user exists

 401

 

Unauthorized 


Related topics

Format-of-API-examples

Create-local-user

Search-local-user

Edit-local-user

Update-local-user-password

 

 

 

 

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