# POST /api/v4/teams/{}/channels/search_archived is deprecated

Mattermost API deprecated POST /api/v4/teams/{id}/channels/search_archived without giving a shutdown date yet.

Mattermost announced the deprecation of POST /api/v4/teams/{id}/channels/search_archived on October 1, 2025, without a shutdown date. The endpoint has been deprecated in favour of another route, and calls to it will eventually fail.

## What to use instead

Call POST /api/v4/channels/search with the deleted parameter set to true instead.

- API: Mattermost API (*.cloud.mattermost.com)
- Kind: Endpoint removal
- Announced: October 1, 2025
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `POST /api/v4/teams/{id}/channels/search_archived`
- Source: [Announcement](https://docs.mattermost.com/product-overview/deprecated-features.html)
- Verified: November 6, 2026, against Mattermost API's own pages
- Page: https://www.okapi.bot/providers/mattermost-api/breaking-changes/post-api-v4-teams-channels-search-archived-is-deprecated/

## Mattermost API's words

> has been deprecated in favour of /api/v4/channels/search with the deleted parameter.

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