Request Information

URI Parameters

None.

Body Parameters

ModifyUserPinRequest

ModifyUserPinRequest
NameDescriptionTypeAdditional information
UserId

User ID of technician who will be changing PIN values

string

Required

NewPIN

New PIN value

string

Required

Matching regular expression pattern: ([0-9]+)

Max length: 4

Min length: 4

ConfirmNewPIN

New PIN value

string

Required

Matching regular expression pattern: ([0-9]+)

Max length: 4

Min length: 4

OperatorId

Operator ID for the operator authorizing the PIN change

string

Required

OperatorPassword

Password for the operator authorizing the PIN change

string

Required

Request Formats

application/json, text/json

Sample:
{
  "UserId": "User01",
  "NewPIN": "1234",
  "ConfirmNewPIN": "1234",
  "OperatorId": "lmsoper",
  "OperatorPassword": "lmsoperPassword"
}

application/xml, text/xml

Sample:
<ModifyUserPinRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SaG.API.Models.Requests.User">
  <ConfirmNewPIN>1234</ConfirmNewPIN>
  <NewPIN>1234</NewPIN>
  <OperatorId>lmsoper</OperatorId>
  <OperatorPassword>lmsoperPassword</OperatorPassword>
  <UserId>User01</UserId>
</ModifyUserPinRequest>

application/x-www-form-urlencoded

Sample:
UserId=User01&NewPIN=1234&ConfirmNewPIN=1234&OperatorId=lmsoper&OperatorPassword=lmsoperPassword

Response Information

Resource Description

ModifyUserPinResponse

ModifyUserPinResponse
NameDescriptionTypeAdditional information
Header

ResponseHeader

None.

Body

ModifyUserPinResponseBody

None.

Response Header Description

ResponseHeader
NameDescriptionTypeAdditional information
Message

Message

string

None.

StatusCode

Status code

ResponseStatus

None.

Status

Status

string

None.

ErrorId

Error id

string

None.

Response Body Description

ModifyUserPinResponseBody
NameDescriptionTypeAdditional information
PinModified

Flag to show if PIN was successfully changed

boolean

None.

Response Formats

application/json, text/json

Sample:
{
  "Header": {
    "Message": "",
    "StatusCode": 0,
    "Status": "Ok",
    "ErrorId": null
  },
  "Body": {
    "PinModified": true
  }
}

application/xml, text/xml

Sample:
<ModifyUserPinResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SaG.API.Models.Responses.User">
  <Body xmlns:d2p1="http://schemas.datacontract.org/2004/07/SaG.API.Models.Responses.User" xmlns="http://schemas.datacontract.org/2004/07/SaG.API.Models.Responses">
    <d2p1:PinModified>true</d2p1:PinModified>
  </Body>
  <Header xmlns="http://schemas.datacontract.org/2004/07/SaG.API.Models.Responses">
    <ErrorId i:nil="true" />
    <Message></Message>
    <Status>Ok</Status>
    <StatusCode>Ok</StatusCode>
  </Header>
</ModifyUserPinResponse>

© 2025 Sargent and Greenleaf