---
title: "Enable Totp"
method: POST
path: "/auth/totp/enable"
tags: ["General APIs with JWT"]
---

# Enable Totp

`POST /auth/totp/enable`

## Request

- Base URL: `https://lium.io/api`
- URL: `https://lium.io/api/auth/totp/enable`
- Auth: HTTP bearer

Turns two-factor on with a first code from the authenticator; the recovery codes are shown only here.
Every other session of the account ends, so one an attacker already holds does not outlive the change; API keys
stay (the user rotates them on their own).

## Request body

- TotpCodeRequest
  - `code` string, required

## Response `200`

Successful Response

- TotpRecoveryCodesResponse
  - `recovery_codes` string[], required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-12** `ea95bc2e1a0f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lium/apis/lium-backend-api/changes/auth/totp/enable/post.md)

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) - [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lium/apis/lium-backend-api/revisions/e13b07d90cfc?raw)
