---
title: "Changes to Update or Create user preferences for a specific subscription topic"
method: PUT
path: "/users/{user_id}/preferences/{topic_id}"
---

# Changes to Update or Create user preferences for a specific subscription topic

`PUT /users/{user_id}/preferences/{topic_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 55 revisions.

- **2026-07-29** `f76bed79a913`: 5 breaking
- **2025-10-17** `e67d02739533`: 2 info

## Changes

- **2026-07-29** `f76bed79a913`: 5 breaking
  - added `#/components/schemas/PreferenceStatus` to the `topic/status` request property `allOf` list
  - removed the enum value `OPTED_IN` of the request property `topic/status`
  - removed the enum value `OPTED_OUT` of the request property `topic/status`
  - removed the enum value `REQUIRED` of the request property `topic/status`
  - the `topic/status` request property type changed from `string` to no type
- **2025-10-17** `e67d02739533`: 2 info
  - api tag `User Preferences` added
  - api tag `UsersPreferences` removed

---

[Operation](https://skmtc.dev/trycourier/apis/courier/docs/users/:user_id/preferences/:topic_id/put.md) - [API](https://skmtc.dev/trycourier/apis/courier.md) - [Page](https://skmtc.dev/trycourier/apis/courier/changes/users/:user_id/preferences/:topic_id/put)