Resetting a PIN

Request

To reset a PIN when the operation has been initiated by the user and the existing PIN is known, send a PUT request to:

http://<server>:<port>/adm/v1/user/accounts/actions/changePin

A PIN cannot be changed if its status is LOCKED. (See Getting the status of all PINs for the account.)

Headers

Content-Type: application/json
Authorisation
nv-tenant-id

Mandatory arguments

None

Example

A PUT request with this payload changes the PIN for the specified user:

{
    "newValue":"resetPIN"
}

Response

A successful request returns an HTTP 200 status.
An unsuccessful request returns an HTTP 400 status, the response includes details of the error.

Example

{
    "matchedCount": 1,
    "modifiedCount": 1
}

See also

For full details of this API, see Account and Device Manager (ADM) API documentation.