Verify Mfa — POST /api/v1/auth/mfa/verify
Verify Mfa
Exchange a challenge token plus a second factor for a real session.
Endpoint: POST /api/v1/auth/mfa/verify
Authentication: No access token or API key is needed.
Parameters
Section titled “Parameters”This endpoint takes no parameters.
Request body
Section titled “Request body”| Content type | Body | Required |
|---|---|---|
application/json | MfaVerifyRequest | yes |
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
200 | Successful Response | TokenResponse (application/json) |
422 | Validation Error | HTTPValidationError (application/json) |
Errors this endpoint returns, read from its source code:
400, with the message “Provide either code or recovery_code”401, with the message “Invalid verification code”
Statuses not listed here are explained in Errors and retries.
More details
Section titled “More details”- Group: Authentication
- Operation ID:
verify_mfa_api_v1_auth_mfa_verify_post - Source code:
backend/app/routers/mfa.py, line 352 - Specification: OpenAPI JSON