Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

General Information

...

ServiceAPIMethodData ModelsWorkflow
urac/admin/user/pinPUTUsers

Description

This API edits, resets, or deletes the pin information of a user that has a username, email, or id that matches the one sent in the user object in the request body.

Input

...

Type: application/json
NameSourceMandatoryTypeSpecial FormatDescription
userBodyYESObjectIncludes one of id, username, or emailUser Object

One of the following should exist under the user object:

NameMandatoryTypeSpecial FormatDescription
idYESStringN/AUser ID
usernameYESStringN/AUsername
emailYESStringN/AUser Email


pinBodyYESObjectOne of delete or reset with allowedPin Object

One of the following should exist under the pin object:

Code Block
titlePin Object
linenumberstrue
collapsetrue
pin: {
	delete: boolean

	OR: 

	reset: boolean,
	allowed: boolean

	OR: 

	reset: boolean
}



Output

...

Response

SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response 

Valid Response

Code Block
languagejs
titleValid Response Sample
linenumberstrue
collapsetrue
{ 
  result: true,
  data: true
}

Invalid Response

Code Block
languagejs
titleError Response Sample
linenumberstrue
collapsetrue
{
    "result":false,
    "errors":{
        "codes":[602],
        "details":[
            {
                "code":602,
                "message":"Model error: + %model_error%"
            }
        ]
    }
}

Response schema

Follow this link to check out the response JSON Schema

SOAJS Error Codes



Code
Description
400

Business logic required data are missing

520

Unable to find user

525

Unable to generate pin at this time

602Model error: + %model_error%