---
title: "Archive a preference section"
method: DELETE
path: "/preferences/sections/{section_id}"
tags: ["Preference Topics"]
---

# Archive a preference section

`DELETE /preferences/sections/{section_id}`

Archive a workspace preference. The workspace preference must be empty: delete its topics first, otherwise the request fails with 409.

## Path parameters

- `section_id` string, required

## Response `204`

Successfully archived.

## Other responses

- `404` — Not Found
- `409` — Conflict

## Changes

- **2026-07-29** `f76bed79a913` — 2 info
  - api tag `Preference Topics` added
  - api tag `Workspace Preferences` removed
- **2026-06-26** `61131080b185` — 3 info
  - api operation id `preferenceSections_archive` removed and replaced with `workspacePreferences_archive`
  - api tag `Workspace Preferences` added
  - api tag `Preference Sections` removed
- **2026-06-24** `124a60dd716b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/preferences/sections/:section_id/delete.md)

---

[API](https://skmtc.dev/trycourier/apis/courier.md) · [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/cb8586034158/schema)