---
title: "Set Preferred MFA Method"
method: PATCH
path: "/v1/users/{id}/mfa/preferred"
tags: ["MFA API"]
---

# Set Preferred MFA Method

`PATCH /v1/users/{id}/mfa/preferred`

Use this endpoint to set the preferred MFA method for a user. The selected method must already be enabled.

## Path parameters

- `id` string, required

## Request body

- MFAPreferredInput — Information required to set the preferred MFA method.
  - `mfaType` 'app' | 'email' | 'sms', required — The MFA type to set as preferred.
  - `secret` string — The TOTP secret (required for app-based MFA).

## Response `200`

Preferred MFA method updated successfully.

- object
  - `preferredType` string

## Other responses

- `400`
- `404`
- `500`

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)