What it means
valid password needs an authenticator or recovery code.
How to handle it
Submit a current authenticator code or unused recovery code through the route that requested verification.
Wire contract
| Code | mfa_required |
|---|---|
| Class | permission |
| HTTP status | 403 |
| Meta keys | None |
| Raised | Yes |
The response uses the standard {"error": {…}} envelope. Branch on error.code, not the human-readable message. Preserve request_id when reporting a failure.