User

Set TOTP MFA key

Enable MFA on this account using an TOTP token. First create a new key via userGenerateNewTotpMfaKey.

post/api/user/mfa/totp/set-key

Request

Request body

keystring required

Secret key obtained through userGenerateNewMfaKey.

totpTokenstring required

TOTP token that is valid for the key (to ensure the device is configured correctly)

Response

OK

successboolean required

Whether the operation succeeded

errorstring

Optional error description (set if 'success' was false)

recoveryCodesstring[] required

10 recovery codes, which can be used in case you've lost access to your MFA TOTP app. Recovery codes are single use. Once you've used a recovery code once, it can not be used again.

Changes

No recorded changes to this operation across all 1 revision of this API.