---
title: "Reset User Totp"
method: POST
path: "/api/users/{user_id}/reset-2fa"
tags: ["security", "security"]
---

# Reset User Totp

`POST /api/users/{user_id}/reset-2fa`

## Request

- Base URL: `https://app.sentientmail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sentientmail.com/api/users/{user_id}/reset-2fa`
- Auth: none declared

Clear a teammate's two-factor enrollment so they can set it up again.
Two-factor state belongs to the ACCOUNT, which the home unit owns: the
target must be homed in the active unit.

## Path parameters

- `user_id` string, uuid, required

## Cookies

- `esp_session` string, nullable

## Request body

- ResetTotpBody
  - `current_password` string, required
  - `reason` string, nullable

## Response `200`

Successful Response

- ResetTotpResponse
  - `user_id` string, required
  - `email` string, required
  - `was_enrolled` boolean, required
  - `sessions_revoked` integer, required
  - `notified` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sentientmail/apis/sentientmail.md) · [All operations](https://skmtc.dev/sentientmail/apis/sentientmail/llms.txt) · [OpenAPI document](https://skmtc.dev/sentientmail/apis/sentientmail/revisions/4c87ece26935?raw)