Initiate a forgot username request by using an authentication mechanism.

Initiates a forgot username request for the user. Each step defines a method to verify the user's identity. Valid methods are email, emailotp, smsotp, voiceotp, totp, fingerprint, and userpresence. A transaction identifier, steps remaining, and the next step to perform are returned in the response. When multiple steps are associated with the transaction, call the POST /v1.0/usc/username/recovery/{trxId}/validator API to verify the user's identity until only one step remains. When one step remains, call the PUT /v1.0/usc/username/recovery/{trxId} to verify the last step and recover the user's user name. The username is delivered via email after the user's identity is verified. The email method sends the username directly to the user's email. The method cannot be combined with other authentication mechanisms.

The totp, fingerprint, and userpresence verification methods require user enrollment. The fingerprint method also works with facial recognition. The other verification methods are transient and do not require user enrollment.

When the system is unable to recover the username, the audit event generated will contain the cause of the error.

Entitlements required: recoverUsername (Recover user name).