Start MFA enrollment during an enforced sign-in
POST
/_torii/auth/mfa/enroll
const url = 'https://your-app.torii.so/_torii/auth/mfa/enroll?_is_native=false';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"challengeToken":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://your-app.torii.so/_torii/auth/mfa/enroll?_is_native=false' \ --header 'Content-Type: application/json' \ --data '{ "challengeToken": "example" }'For a login that returned mfa_enrollment_required: mints a pending TOTP secret keyed on the challenge token. Returns the otpauth URI + manual key; no session yet.
Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ” Origin
string
Host
string
Query Parameters
Section titled “Query Parameters ” _is_native
boolean
Request Body required
Section titled “Request Body required ” Media type application/json
object
challengeToken
required
string
Example generated
{ "challengeToken": "example"}Responses
Section titled “ Responses ”OK
Media type application/json
object
Example generated
{}