# The alpha thread messages API is deprecated

Notion API deprecated /v1/threads/{id}/messages* without giving a shutdown date yet.

## What to use instead

Call POST /v1/sessions/{}/events/query and read agent replies from agent.message events.

- API: Notion API (api.notion.com)
- Kind: Removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/v1/threads/{id}/messages*`
- Source: [Announcement](https://developers.notion.com/guides/notion-agent-apis/upgrading-to-public-beta)
- Verified: November 6, 2026, against Notion API's own pages
- Page: https://www.okapi.bot/providers/notion-api/breaking-changes/the-alpha-thread-messages-api-is-deprecated/

## Notion API's words

> The alpha routes are deprecated If you use the alpha routes for listing agents, threads, messages, or chat, migrate to their replacements.

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