Skip to main content

InitiateTOTPSetup starts TOTP authenticator setup.

POST 
/api/v1/auth/me/mfa/totp/setup

Response​

  • secret: Base32-encoded secret for manual entry
  • qr_code_url: URL for QR code image
  • backup_codes: Emergency backup codes (save these!)

Flow​

  1. Call this endpoint to get setup info
  2. User scans QR code with authenticator app
  3. Call ConfirmTOTPSetup with code from app

Request​

Responses​

A successful response.