/api/auth/two-factor/enable

POST

Use this endpoint to enable two factor authentication. This will generate a TOTP URI and backup codes. Once the user verifies the TOTP URI, the two factor authentication will be enabled.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successful response

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/auth/two-factor/enable' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "password": "string",
    "issuer": "string"
}'

Response Example

200 - Example 1

{
    "totpURI": "string",
    "backupCodes": [
        "string"
    ]
}

Modified at 2025-09-02 02:31:01

/api/auth/two-factor/generate-backup-codes

/api/auth/two-factor/disable