---
title: "Update 2FA method"
method: PUT
path: "/v1/2fa/methods/{method-name}"
tags: ["Two-Factor Authentication"]
---

# Update 2FA method

`PUT /v1/2fa/methods/{method-name}`

Update an existing two-factor authentication method. Only the fields provided
in the request body will be modified. Requires MANAGE_2FA_METHODS access right.

## Path parameters

- `method-name` string, required

## Request body

- TwoFactorMethodInput — Two-factor authentication method create/update request
  - `name` string, required — Method name
  - `driver` string, required — Driver name (e.g., "TOTP", "Message")
  - `description` string — Method description
  - `configuration` object — Driver-specific configuration

## Response `200`

2FA method updated successfully

- TwoFactorMethod — Two-factor authentication method
  - `name` string — Method name (unique identifier)
  - `driver` string — Driver name (e.g., "TOTP", "Message")
  - `description` string — Method description
  - `isValid` boolean — Whether the method configuration is valid
  - `configuration` object — Driver-specific configuration (structure depends on the driver)

## Other responses

- `400` — Unknown driver
- `403` — User does not have MANAGE_2FA_METHODS access right
- `404` — Method not found
- `500` — Database failure

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)
