Skip to main content
POST
Initiate an MFA challenge

Body

application/json
mfaToken
string
required

Short-lived MFA session token issued when a login requires MFA.

Example:

"eyJhbGciOiJIUzI1NiJ9..."

mfaType
enum<string>
required

Use email to send a verification code. The app value is accepted but does not send a code; authenticator apps generate passcodes locally.

Available options:
app,
email
Example:

"app"

Response

The challenge request succeeded. For email, a verification code was sent. For app, no code is sent.

message
string
required

Human-readable acknowledgement that the challenge was dispatched.

Example:

"MFA challenge initiated"