v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB
2FA Reset

Poll the status of a 2FA reset

Step 2 — poll while the user completes identity verification, and again after /complete to confirm the new factor was enrolled. status tracks the reset lifecycle (INITIATEDPENDING_REVIEWLIVENESS_PASSEDCOMPLETED, or terminal REJECTED / EXPIRED). For totp / passkey resets, enrollmentStatus gives a finer signal for the enrollment step: PENDING once verification has passed but the new factor has not yet been submitted, COMPLETED once it has. SMS resets have no enrollment step, so enrollmentStatus is null.

post/user/2fa/reset/status

Request body

userIdstring uuid required
resetIdstring uuid required

Response

Current state of the reset.

resetIdstring uuid required
factor'sms' | 'totp' | 'passkey' required
status'INITIATED' | 'PENDING_REVIEW' | 'LIVENESS_PASSED' | 'COMPLETED' | 'REJECTED' | 'EXPIRED' required
enrollmentStatus'PENDING' | 'COMPLETED' nullable required

Enrolment-tail signal for totp / passkey resets; null for sms.

expiresAtstring date-time required
completedAtstring date-time

Present once the reset reached COMPLETED.