Skip to main content
POST
Complete login when user has two-factor authentication enabled.

Body

application/json

The challenge token from the login response and the user's one-time code.

Request body for POST /api/v1/tokens/two-factor: the challenge token from the login response plus the user's one-time code. Property names are snake_case to match the wire format of the token endpoints.

The action binds the body as a loose JObject at runtime; this type exists so the API docs describe the body instead of an opaque data parameter (see [OpenApiRequestBody] on the action).

challenge_token
string | null

The challenge_token returned by POST /api/v1/tokens when two-factor authentication is required. Echo it back verbatim.

code
string | null

The user's one-time code: the emailed code for an Email challenge, or the current code from their authenticator app for a Totp challenge.

Response

The code was accepted; the access token (JWT) is returned.

access_token
string | null
authentication_callback_url
string | null
expires_in
integer<int32>
id_token
string | null
refresh_token
string | null
token_type
string | null