---
title: "Confirm TOTP enrolment with a first code"
method: POST
path: "/v2/users/me/mfa/totp/confirm"
tags: ["Users"]
---

# Confirm TOTP enrolment with a first code

`POST /v2/users/me/mfa/totp/confirm`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/users/me/mfa/totp/confirm`
- Auth: HTTP bearer

Turns MFA on and returns the backup codes **once**. Every other
interactive session of the user is ended.

## Request body

- object
  - `code` string, required

## Response `200`

`{ success: true, enabled: true, backupCodes: string[], sessionsRevoked }`

## Other responses

- `400`: Bad Request
- `401`: `MFA_CODE_INVALID`
- `403`: Forbidden
- `404`: Not Found
- `409`: `MFA_ALREADY_ENABLED`, `MFA_ENROLMENT_EXPIRED`
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)