Sign in authentication

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

Without 2FA: Provide the username and password in the request. Upon successful authentication,
the endpoint will return an authentication token to be used in subsequent requests.

With 2FA:

First, provide the username and password in the request.

The endpoint will not return a token immediately.
Instead, it will return an otp_session_state, which represents the current 2FA session.

Next, use the same endpoint (/auth/sign_in) with the following parameters: otp_attempt
and otp_session_state.

Upon successful 2FA 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