# Update Multi-Factor Method API

API documentation for the FusionAuth Update Multi-Factor Method API.

> For the index of this section of the site, see [llms.txt](https://4002.18-224-161-104.sslip.io/docs/llms.txt)

This API updates the display name of a single configured multi-factor method for a User.

This operation only updates the method display name. It does not modify the MFA method type or delivery configuration.

## Request

[API Key Authentication](https://4002.18-224-161-104.sslip.io/docs/apis/authentication.md#api-key-authentication)

Update a single multi-factor method by User Id

`PUT /api/user/two-factor/{userId}?methodId={methodId}`

Available since `1.68.0`

### Request Headers

`X-FusionAuth-TenantId`

*   Type: `String`
*   Optional

The unique Id of the tenant used to scope this API request.

The tenant Id is not required on this request even when more than one tenant has been configured because the tenant can be identified based upon other values in the request or it is otherwise not required.

Specify a tenant Id on this request when you want to ensure the request is scoped to a specific tenant. The tenant Id may be provided through this header or by using a tenant locked API key to achieve the same result.

See [Making an API request using a Tenant Id](https://4002.18-224-161-104.sslip.io/docs/apis/authentication.md#making-an-api-request-using-a-tenant-id) for additional information.

### Path Parameters

`userId`

*   Type: `UUID`
*   Required

The Id of the User for whom to update Multi-Factor authentication.

### Query Parameters

`methodId`

*   Type: `String`
*   Required

The Id of the multi-factor method to update.

### Request Body

`name`

*   Type: `String`
*   Optional

The display name for the configured multi-factor method.

The maximum length is 256 characters.

If omitted, the method name will be cleared.

Example Request JSON

```json
{
  "name": "Work phone"
}
```

## Response

*Response Codes*

| Code | Description |
| --- | --- |
| 200 | The request was successful. The response will be empty. |
| 400 | The request was invalid and/or malformed. The response will contain an [Errors](https://4002.18-224-161-104.sslip.io/docs/apis/errors.md) JSON Object with the specific errors. |
| 401 | You did not supply a valid Authorization header. The header was omitted or your API key was not valid. The response will be empty. See [Authentication](https://4002.18-224-161-104.sslip.io/docs/apis/authentication.md). |
| 404 | The User does not exist. The response will be empty. |
| 500 | There was an internal error. A stack trace is provided and logged in the FusionAuth log files. The response will be empty. |
| 503 | The search index is not available or encountered an exception so the request cannot be completed. The response will contain a JSON body. |

Related

[APIs Disable Multi-Factor API API documentation for the FusionAuth Disable Multi-Factor API. fusionauth apirest apihttp api](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/disable-multi-factor.md)

[APIs Enable Multi-Factor API API documentation for the FusionAuth Enable Multi-Factor API. fusionauth apirest apihttp api](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/enable-multi-factor.md)

[APIs Generate a Secret API API documentation for the FusionAuth Generate a Secret API. fusionauth apirest apihttp api](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/generate-a-secret.md)

[APIs Generate Recovery Codes API API documentation for the FusionAuth Generate Recovery Codes API. fusionauth apirest apihttp api](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/generate-recovery-codes.md)
---

## Other pages in Two Factor

> For the full index of this section, see [Apis](https://4002.18-224-161-104.sslip.io/docs/llms-apis.txt).

- [Disable Multi-Factor API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/disable-multi-factor.md): API documentation for the FusionAuth Disable Multi-Factor API.
- [Enable Multi-Factor API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/enable-multi-factor.md): API documentation for the FusionAuth Enable Multi-Factor API.
- [Generate a Secret API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/generate-a-secret.md): API documentation for the FusionAuth Generate a Secret API.
- [Generate Recovery Codes API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/generate-recovery-codes.md): API documentation for the FusionAuth Generate Recovery Codes API.
- [Multi-Factor API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor.md): Learn about the APIs for enabling and disabling multi-factor authentication for users.
- [Retrieve Multi-Factor Status API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/retrieve-multi-factor-status.md): API documentation for the FusionAuth Retrieve Multi-Factor Status API.
- [Retrieve Recovery Codes API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/retrieve-recovery-codes.md): API documentation for the FusionAuth Retrieve Recovery Codes API.
- [Send a Multi-Factor Code During Login or Step Up API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/send-a-multi-factor-code-during-login-or-step-up.md): API documentation for the FusionAuth Send a Multi-Factor Code During Login or Step Up API.
- [Send a Multi-Factor Code When Disabling MFA API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/send-a-multi-factor-code-when-disabling-mfa.md): API documentation for the FusionAuth Send a Multi-Factor Code When Disabling MFA API.
- [Send a Multi-Factor Code When Enabling MFA API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/send-a-multi-factor-code-when-enabling-mfa.md): API documentation for the FusionAuth Send a Multi-Factor Code When Enabling MFA API.
- [Start Multi-Factor API](https://4002.18-224-161-104.sslip.io/docs/apis/two-factor/start-multi-factor.md): API documentation for the FusionAuth Start Multi-Factor API.