# Api:Two-Factor Authentication

**Page:** api/api-two-factor-authentication

[Download Raw Markdown](./api/api-two-factor-authentication.md)

---

## API Endpoints Summary

- **POST** `/api/v1/users/auth/2fa/verify` — Verify 2FA Code During Login
- **POST** `/api/v1/users/auth/2fa/setup` — Initialize 2FA Setup
- **POST** `/api/v1/users/auth/2fa/verify-setup` — Complete 2FA Setup
- **GET** `/api/v1/users/auth/2fa/status` — Get 2FA Status
- **DELETE** `/api/v1/users/auth/2fa` — Disable 2FA
- **POST** `/api/v1/users/auth/2fa/backup-codes/regenerate` — Regenerate Backup Codes
- **PUT** `/api/v1/users/auth/2fa/token-gate` — Set 2FA token gate preference
- **PATCH** `/api/v1/users/auth/2fa/token-gate` — Set 2FA token gate preference

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```