---
title: "Notion API API changes, deprecations and deadlines | Harbyn"
description: "Notion API: 0 upcoming deadlines and 46 recorded changes as of 2026-10-25, each with its source."
canonical: "https://harbyn.com/vendors/notion"
last-updated: 2026-10-17
---

# Notion API: API changes and deadlines

Markdown version of <https://harbyn.com/vendors/notion>.

Developer platform. 0 upcoming deadlines, 46 recorded changes. Every entry cites the Notion API page we read it from.

## What we read

The Notion API pages and feeds our ingestion visits, politely and on a schedule.

- **Changelog**: <https://developers.notion.com/page/changelog.md>
- **Releases**: <https://api.github.com/repos/makenotion/notion-sdk-js/releases?per_page=20>
- **Changelog**: <https://api.github.com/advisories?affects=@notionhq/client&per_page=20&sort=published&direction=desc>

## What the scanner looks for

How `harbyn scan` recognises Notion API in a repository, on your machine. Nothing leaves it.

- **Packages**: `npm @notionhq/client`
- **API hosts**: `api.notion.com`

## Upcoming deadlines

No upcoming Notion API deadline in the feed right now.

## Change history

Newest first, by the date Notion API announced it. This is the archive: past changes are not warnings, and changes we recorded after they took effect are marked as such.

### October 2026

- Oct 16, 2026, Behavior change: [Partial update\_content edits return warnings](https://harbyn.com/changes/notion/2026-10-16-partial-update-content-edits-return-warnings.md)
- Oct 15, 2026, Feature: [Comment-only connections can retrieve their own bot user](https://developers.notion.com/page/changelog.md)
- Oct 14, 2026, Feature: [List page backlinks in Notion MCP](https://developers.notion.com/page/changelog.md)
- Oct 14, 2026, Feature: [Look up permission groups in Notion MCP](https://developers.notion.com/page/changelog.md)
- Oct 14, 2026, Feature: [Search supports filter\_properties](https://developers.notion.com/page/changelog.md)
- Oct 13, 2026, Feature: [New Notion MCP deletion tools](https://developers.notion.com/page/changelog.md)
- Oct 13, 2026, Feature: [Four Notion MCP comment tools added](https://developers.notion.com/page/changelog.md)
- Oct 9, 2026, Deprecation: [Admin API list endpoints take start\_cursor, cursor deprecated](https://harbyn.com/changes/notion/2026-10-09-admin-api-list-endpoints-accept-start-cursor-2.md)
- Oct 9, 2026, Behavior change: [Data source updates keep omitted descriptions and options](https://harbyn.com/changes/notion/2026-10-09-data-source-schema-update-fixes.md)
- Oct 9, 2026, Breaking change: [notion-download-skill returns markdown for Skills without files](https://harbyn.com/changes/notion/2026-10-09-notion-download-skill-returns-markdown-for-skills-without-files.md)
- Oct 8, 2026, Feature: [Control notifications from page writes](https://developers.notion.com/page/changelog.md)
- Oct 7, 2026, Behavior change: [notion-get-tool-access is optional](https://harbyn.com/changes/notion/2026-10-07-notion-get-tool-access-is-optional.md)
- Oct 7, 2026, Behavior change: [Hosted Notion MCP sessions list one content-search tool](https://harbyn.com/changes/notion/2026-10-07-one-search-tool-in-notion-mcp.md)
- Oct 7, 2026, Behavior change: [Notion MCP returns OpenAI's search and fetch shape to ChatGPT](https://harbyn.com/changes/notion/2026-10-07-openai-s-search-and-fetch-shape-for-chatgpt.md)
- Oct 7, 2026, Feature: [Status group filters beta](https://developers.notion.com/page/changelog.md)
- Oct 7, 2026, Feature: [notion-update-page returns optional warnings](https://developers.notion.com/page/changelog.md)
- Oct 6, 2026, Feature: [Create teamspace root pages with Notion MCP](https://developers.notion.com/page/changelog.md)
- Oct 6, 2026, Rate limit: [No more tool-specific Notion MCP rate limits](https://developers.notion.com/page/changelog.md)
- Oct 5, 2026, Breaking change: [notion-fetch no longer signs file URLs by default](https://harbyn.com/changes/notion/2026-10-05-notion-fetch-no-longer-signs-file-urls-by-default.md)
- Oct 2, 2026, Behavior change: [Oversized page edits return HTTP 400](https://harbyn.com/changes/notion/2026-10-02-page-edits-return-400-when-a-page-is-too-large-to-load.md)

### September 2026

- Sep 30, 2026, Behavior change: [Markdown content API and Notion MCP return custom blocks instead of unknown elements](https://harbyn.com/changes/notion/2026-09-30-custom-blocks-in-markdown.md)
- Sep 30, 2026, Feature: [New SIEM event for the AI meeting notes consent setting](https://developers.notion.com/page/changelog)
- Sep 30, 2026, Feature: [Notion-flavored Markdown preview](https://developers.notion.com/page/changelog.md)
- Sep 29, 2026, Retirement: [Completing the query tool update in Notion MCP](https://harbyn.com/changes/notion/2026-09-29-completing-the-query-tool-update-in-notion-mcp.md) (effective Sep 29, 2026)
- Sep 28, 2026, Rate limit: [Higher Notion MCP search and query limits](https://developers.notion.com/page/changelog.md)
- Sep 25, 2026, Behavior change: [Custom emoji icons are validated](https://harbyn.com/changes/notion/2026-09-25-custom-emoji-icons-are-validated.md)
- Sep 24, 2026, Behavior change: [Timed-out page writes return HTTP 504](https://harbyn.com/changes/notion/2026-09-24-page-writes-return-504-when-a-request-times-out.md)
- Sep 24, 2026, Rate limit: [Rate-limit wait and reason details added to responses](https://developers.notion.com/page/changelog.md)
- Sep 23, 2026, Behavior change: [Notion icon URLs are validated](https://harbyn.com/changes/notion/2026-09-23-notion-icon-urls-are-validated.md)
- Sep 22, 2026, Behavior change: [Generic file MIME types are resolved from the filename extension](https://harbyn.com/changes/notion/2026-09-22-application-octet-stream-resolves-from-the-file-extension.md)
- Sep 22, 2026, Feature: [File Upload API accepts CAD and 3D model formats](https://developers.notion.com/page/changelog)
- Sep 17, 2026, Feature: [New notion-get-tool-access tool](https://developers.notion.com/page/changelog.md)
- Sep 17, 2026, Feature: [User lookup in notion-ai-search](https://developers.notion.com/page/changelog.md)
- Sep 17, 2026, Behavior change: [MCP search drops unavailable filters instead of failing](https://harbyn.com/changes/notion/2026-09-17-search-drops-unavailable-options-instead-of-failing.md)
- Sep 10, 2026, Feature: [AI search accepts filters and sort options](https://developers.notion.com/page/changelog.md)
- Sep 10, 2026, Behavior change: [Content queries to notion-search can route to AI search](https://harbyn.com/changes/notion/2026-09-10-ai-search-accepts-filters-and-notion-search-routes-content-queries-to-it-2.md)
- Sep 10, 2026, Feature: [Session URL shorthand for Custom Agent session tools](https://developers.notion.com/page/changelog.md)
- Sep 10, 2026, Behavior change: [Custom Agent session tools return specific validation and conflict errors](https://harbyn.com/changes/notion/2026-09-10-validation-and-conflict-errors-from-custom-agent-session-tools.md)
- Sep 9, 2026, Rate limit: [Faster retries and plan-based rate limits](https://developers.notion.com/page/changelog.md)
- Sep 2, 2026, Behavior change: [notion-search is now keyword-only](https://harbyn.com/changes/notion/2026-09-02-notion-mcp-splits-keyword-search-and-ai-search.md)
- Sep 2, 2026, Feature: [New notion-ai-search tool](https://developers.notion.com/page/changelog.md)
- Sep 2, 2026, Feature: [Page covers and icons in notion-fetch responses](https://developers.notion.com/page/changelog.md)
- Sep 2, 2026, Feature: [Rich text in data source queries](https://developers.notion.com/page/changelog.md)
- Sep 2, 2026, Feature: [Typed databases in the REST API](https://developers.notion.com/page/changelog.md)
- Sep 1, 2026, Breaking change: [Free workspace block limits now apply to the REST API](https://harbyn.com/changes/notion/2026-09-01-free-workspace-block-limits-now-apply-to-the-rest-api.md)
- Sep 1, 2026, Behavior change: [Upgrade prompts for Custom Agent tools in Notion MCP](https://harbyn.com/changes/notion/2026-09-01-upgrade-prompts-for-custom-agent-tools-in-notion-mcp.md)
