Sign in with recovery code

This endpoint allows users to authenticate using one of their recovery codes.
Depending on whether the user has Two-Factor Authentication (2FA) enabled,
the authentication flow will vary:

Without 2FA: This endpoint is disabled, because it requires the otp_session_state generated in
POST /auth/sign_in.

With 2FA:

First, provide one of your activated recovery code along with the otp_session_state
generated by calling POST /auth/sign_in.

Upon successful Recovery code verification, the endpoint will return the authentication token.

Responses

🟢200OK

application/json

Successful Sign In

Body

Example

{
    "status": 200,
    "status_text": "OK",
    "username": "john_doe",
    "token": "string",
    "sign_in_count": 10,
    "role": "User",
    "timezone": "UTC",
    "verified": true,
    "provider": "email",
    "organization": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "name": "Example Organization"
    }
}

🟠401Unauthorized

Request

Request Code Samples

Responses