# PUT /v1/users/{}/preferences/{}/* is deprecated

Knock API deprecated PUT /v1/users/{}/preferences/{}/* without giving a shutdown date yet.

Knock deprecated the PUT /v1/users/{}/preferences/{}/* endpoint without a shutdown date. The endpoint updates channel types in a specific user preference set, but calls to it will eventually fail. Developers using this path should prepare for its removal.

## What to use instead

Set the whole preference set using PUT /v1/users/{user_id}/preferences/{id} with channel_types, categories, and workflows in the request body.

- API: Knock API (api.knock.app)
- Kind: Endpoint removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `PUT /v1/users/{}/preferences/{}/*`
- Source: [Announcement](https://docs.knock.app/openapi.json)
- Verified: October 26, 2026, against Knock API's own pages
- Page: https://www.okapi.bot/providers/knock-api/breaking-changes/put-v1-users-preferences-is-deprecated/

## Knock API's words

> Updates the channel types in a specific user preference set. This operation is deprecated.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent