---
title: "Changes to PUT /v1/email-preferences"
method: PUT
path: "/v1/email-preferences"
---

# Changes to PUT /v1/email-preferences

`PUT /v1/email-preferences`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 73 revisions.

- **2024-09-16** `cc4dc40e33b6`: 1 breaking
- **2024-08-26** `89342ccb01f2`: 1 breaking, 1 info
- **2024-07-03** `172cebd79b0d`: 1 breaking
- **2024-06-25** `b4392d49b04b`: 1 breaking, 1 info
- **2023-11-28** `7bb0cfb7198b`: 1 breaking, 1 info
- **2023-11-20** `4e9f31f9a8fa`: 1 breaking, 1 info
- **2023-10-31** `0462abc311f4`: 5 info
- **2023-10-17** `a0df00184234`: 1 breaking, 1 info
- **2023-09-19** `19b1f34aceb5`: 1 breaking, 1 info

## Changes

- **2024-09-16** `cc4dc40e33b6`: 1 breaking
  - added the new required request property `preferences/oneOf[subschema #2]/ANNOUNCEMENTS`
- **2024-08-26** `89342ccb01f2`: 1 breaking, 1 info
  - removed `subschema #1, subschema #3, subschema #4` from the `preferences` request property `oneOf` list
  - added `subschema #1, subschema #3, subschema #4` to the `preferences` request property `oneOf` list
- **2024-07-03** `172cebd79b0d`: 1 breaking
  - added the new required request property `preferences/oneOf[subschema #4]/USER_RESEARCH_SURVEYS`
- **2024-06-25** `b4392d49b04b`: 1 breaking, 1 info
  - removed `subschema #2, subschema #3` from the `preferences` request property `oneOf` list
  - added `subschema #2, subschema #3` to the `preferences` request property `oneOf` list
- **2023-11-28** `7bb0cfb7198b`: 1 breaking, 1 info
  - removed `subschema #2, subschema #3` from the `preferences` request property `oneOf` list
  - added `subschema #2, subschema #3` to the `preferences` request property `oneOf` list
- **2023-11-20** `4e9f31f9a8fa`: 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `preferences` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `preferences` request property `oneOf` list
- **2023-10-31** `0462abc311f4`: 5 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
- **2023-10-17** `a0df00184234`: 1 breaking, 1 info
  - the request's body type changed from `array` to `object`
  - added the new optional request property `preferences`
- **2023-09-19** `19b1f34aceb5`: 1 breaking, 1 info
  - removed the enum value `ACTION` of the request property `items/notificationType`
  - added the new `TASK` enum value to the request property `items/notificationType`

---

[Operation](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service/docs/v1/email-preferences/put.md) - [API](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service.md) - [Page](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service/changes/v1/email-preferences/put)