---
title: "PUT /v1/{userId}/mfa"
method: PUT
path: "/v1/{userId}/mfa"
tags: ["[v1] Users"]
---

# PUT /v1/{userId}/mfa

`PUT /v1/{userId}/mfa`

## Request

- Base URL: `https://nhse-${ENV}-innovation-service-admin-functions.azurewebsites.net/api`
- URL: `https://nhse-${ENV}-innovation-service-admin-functions.azurewebsites.net/api/v1/{userId}/mfa`
- Auth: none declared

Upsert user MFA configuration

## Path parameters

- `userId` string, uuid, required

## Request body

- object
  - `type` 'none' | 'email' | 'phone', required
  - `phoneNumber` string

## Response `204`

MFA information upserted

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2024-08-29** `a794f49c303c`: 1 info
  - endpoint added
- **2024-08-28** `795ad2980be7`: 1 breaking
  - api path removed without deprecation
- **2024-08-23** `d6bfb6124af3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service/changes/v1/:userId/mfa/put.md)

---

[API](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service.md) - [All operations](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service/revisions/97dbf652314e?raw)