Unregister authenticator app errors - ULM / DIM — SaaS Knowledge Center

The most common errors returned by the Unregister Authenticator App Process.

Invalid password

This Process always requires the user to first provide a password (unless the user onboarded with a social account and uses that account passwordless authentication), even though they are already authenticated. If the user provides an invalid password, the Process returns this response:

**RESPONSE - body**
{
   "processId": "7e034cfd-85fb-464c-a995-8eee3acb98c2",
   "processName": "userManagement.UnregisterAuthenticatorAppAsMFA.v1.0",
   "stepName": "PasswordPrompt",
   "lastStep": false,
   "operationErrors": [
      {
         "code": "invalid-credential",
         "type": "com.uxpsystems.mint.framework.ulm.process.service.ServiceStep.GeneralFailure",
         "message": "Bad credentials",
         "authorities": [
            {
               "authority": "ROLE_USER"
            }
         ]
      }
   ],
   "lastFailedStepAction": {
      "processId": "7e034cfd-85fb-464c-a995-8eee3acb98c2",
      "processName": "userManagement.UnregisterAuthenticatorAppAsMFA.v1.0",
      "displayMessage": "Please provide your password.",
      "parameters": {
         "password": "String"
      }
   }
}

The response also includes a lastStepFailedAction object that repeats the previous Process step’s response, so that the user can re-attempt to submit a valid password.

Error Codes

Below is a list of potential error codes that may be returned during the execution of this Process. Note: See Common Process Error Codes.

HTTP Status	Digital Identity Management Business Error Code	Description
`400`	`authenticator-app-not-registered`	The current user does not have any authenticator app registered.
`400`	`invalid-credential`	The user provided an incorrect password.
`400`	`password-unset`	The user does not have a set password. In order to add a second factor, the user must first set a password (i.e., Update Password Process).

Parent topic:Unregister Authenticator App Process