Account

Mfa setup init

Starts multi factor authentication setup by generating a new secret and returning the QR code and manual setup key for an authenticator app (requires a verified phone number, and is completed by calling MfaVerify).

POST /api/sys/v{version:apiVersion}/account/mfa_setup_init

Authorisation: Minimum role: USER

Request arguments

Name	Type	Source

Request body example

No input arguments

Response

Status: 200 (OK)
Type: DTO_mfa_setup_init_response

Wrapper: DTO_response_wrap

Other statuses: 400 (BadRequest), 403 (Forbidden)

Response body example

DTO_mfa_setup_init_response

Name	Type	ReadOnly	Description
qr_code_base64	String		Qr code base64
manual_setup_key	String		Manual setup key

Generated Aug 4, 2026 18:37