v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
MFA API

Initiate MFA Challenge

Use this endpoint to request a new MFA verification code sent via email or SMS. This is useful when the user needs a fresh code or wants to switch to a different MFA method.

Requires a valid mfaToken obtained from the access token endpoint.

post/v1/login/mfa/challenge

Request body

mfaTokenstring required

The temporary MFA token received from the access token endpoint.

mfaType'app' | 'email' | 'sms' required

The MFA method to use for the challenge.

Response

The MFA challenge was initiated. A verification code has been sent through the requested method.

messagestring

Confirmation that the challenge was initiated.