---
title: "Start Totp Setup"
method: POST
path: "/auth/totp/setup"
tags: ["General APIs with JWT"]
---

# Start Totp Setup

`POST /auth/totp/setup`

## Request

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

A new authenticator secret, pending until /totp/enable confirms it with a code.

## Request body

- TotpSetupRequest
  - `password` string, nullable

## Response `200`

Successful Response

- TotpSetupResponse
  - `secret` string, required
  - `otpauth_uri` 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/setup/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)
