Hanzo
OpenapiIam

Starts enrolling a factor and hands over whatever the person needs to prove…

Starts enrolling a factor and hands over whatever the person needs to prove they hold it: app a fresh secret and the otpauth:// URL to render as a QR code…

POST /v1/iam/mfa/setup/initiate

Addresshttps://api.hanzo.ai/v1/iam/mfa/setup/initiate
MethodPOST
Operationpost_iam_mfa_setup_initiate
AuthAuthorization: Bearer $HANZO_API_KEY

Starts enrolling a factor and hands over whatever the person needs to prove they hold it:

app a fresh secret and the otpauth:// URL to render as a QR code sms a code texted to the number on the account email a code mailed to the address on the account

Nothing is switched on yet, so abandoning this step leaves the account exactly as it was. Response: {status:"ok", data:{mfaType, secret, url}} — secret and url only for the authenticator.

Request

The document declares no body for POST /v1/iam/mfa/setup/initiate. The handler is typed in cloud but its shape is not yet emitted, so the fields are not listed here — ask the MCP door's describe for post_iam_mfa_setup_initiate, which answers from the running route.

Response

The document declares no response body for this operation. It answers 200 on success and the platform error shape on failure — see Errors.

Examples

hanzo iam mfa setup initiate

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page