---
title: "PUT /v1/me"
method: PUT
path: "/v1/me"
tags: ["[v1] Users"]
---

# PUT /v1/me

`PUT /v1/me`

## Request

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

User profile information update

## Request body

- object
  - `givenName` string, required
  - `surname` string, required
  - `mobilePhone` string, nullable
  - `contactByEmail` boolean
  - `contactByPhone` boolean
  - `contactByPhoneTimeframe` 'MORNING' | 'AFTERNOON' | 'DAILY', nullable
  - `contactDetails` string, nullable
  - `organisation` object, required
    - `id` string, uuid, required
    - `isShadow` boolean, required
    - `name` union
      - string
      - string, nullable
    - `size` union
      - string
      - string, nullable
    - `description` union
      - string
      - string, nullable
    - `registrationNumber` string, nullable
  - `howDidYouFindUsAnswers` object, required
    - `event` boolean
    - `eventComment` string
    - `reading` boolean
    - `readingComment` string
    - `recommendationColleague` boolean
    - `recommendationOrg` boolean
    - `recommendationOrgComment` string
    - `searchEngine` boolean
    - `socialMedia` boolean
    - `other` boolean
    - `otherComment` string

## Response `200`

User information updated

- object
  - `id` string, uuid, required

## Other responses

- `400`: Bad request

## Changes

- **2026-09-22** `4c818edd79bf`: 6 breaking, 5 info
  - added the new required request property `givenName`
  - added the new required request property `howDidYouFindUsAnswers`
  - added the new required request property `organisation`
  - added the new required request property `surname`
  - …7 more
- **2026-09-22** `f31374394984`: 1 breaking, 9 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `contactByEmail`
  - removed the request property `contactByPhone`
  - removed the request property `contactByPhoneTimeframe`
  - …7 more
- **2026-09-22** `fc4082ccc5c4`: 2 breaking, 1 warning
  - added the new required request property `givenName`
  - added the new required request property `surname`
  - removed the request property `displayName`
- **2024-11-07** `173650e3e033`: 8 breaking, 2 warning, 11 info
  - the request property `displayName` became required
  - the request property `howDidYouFindUsAnswers` became required
  - the request property `organisation` became required
  - the request property `organisation/id` became required
  - …17 more
- **2024-03-05** `aebedb1b34b1`: 1 info
  - added the new optional request property `howDidYouFindUsAnswers`

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

---

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