Site Home
API Reference
LoginTry for Free

Verify MFA Challenge

post
https://{application_vanity_domain}/api/v1/mfa-challenge/verify-challenge
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Verifies an MFA challenge for a specified authentication factor. If the challenge is passed, the response will include a URL to redirect the user and create an auth session.

If the challenge is not passed, then this API will return a 400 response with a mfa_challenge_verification_failed error code.

Required Permissions

Below is the list of required permissions needed to interact with this API. For each permission, the allowed permission boundaries are also specified.

PermissionBoundaryDescription
mfa-challenge-workflow:executeApplicationThe subject can perform this operation for users associated with the application to which the subject belongs.
Body Params

Verify MFA Challenge Request

Request used to verify an MFA challenge.

string
required

Token used to propagate the state of the MFA request.

string
enum
required

The type of the auth factor whose challenge is being verified.

Allowed:
string
required

The code that will be used to verify the auth factor challenge.

Responses

Updated about 1 month ago

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago