v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-0318386446.4 KB

Mfa Verify

Complete MFA verification during login by validating a TOTP code.

Called after /login returns requires_mfa: true. The mfa_ticket is the aal1 access-token issued by GoTrue; on success it is exchanged for an aal2 session whose cookies are set on the response.

post/api/v1/auth/mfa/verify

Request body

mfa_ticketstring required
factor_idstring required
codestring required

Response

Successful Response

{"stackTrail":"paths:/api/v1/auth/mfa/verify:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}