---
title: "Changes to Replace a preference section"
method: PUT
path: "/preferences/sections/{section_id}"
---

# Changes to Replace a preference section

`PUT /preferences/sections/{section_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 55 revisions.

- **2026-07-29** `f76bed79a913` — 2 info
- **2026-07-09** `49e3cc128b6c` — 3 info
- **2026-06-26** `61131080b185` — 3 info
- **2026-06-24** `124a60dd716b` — 1 info

## Changes

- **2026-07-29** `f76bed79a913` — 2 info
  - api tag `Preference Topics` added
  - api tag `Workspace Preferences` removed
- **2026-07-09** `49e3cc128b6c` — 3 info
  - added the new optional request property `description`
  - added the optional property `description` to the response with the `200` status
  - added the optional property `topics/items/description` to the response with the `200` status
- **2026-06-26** `61131080b185` — 3 info
  - api operation id `preferenceSections_replace` removed and replaced with `workspacePreferences_replace`
  - api tag `Workspace Preferences` added
  - api tag `Preference Sections` removed
- **2026-06-24** `124a60dd716b` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/trycourier/apis/courier/docs/preferences/sections/:section_id/put.md) · [API](https://skmtc.dev/trycourier/apis/courier.md) · [Page](https://skmtc.dev/trycourier/apis/courier/changes/preferences/sections/:section_id/put)