We check Notion's developer changelog every day, because we run production integrations on the Notion API. This page lists the 72 changes we have recorded since monitoring started on 26 March 2026, newest first.
Our last successful check was on 28 September 2026. We are on it; until then this page may miss the newest changes.
1 breaking change and 0 deprecations in the Notion API in the last 90 days. The latest: “Notion app links domain change to notion.com” (15 July 2026).
Labels are assigned automatically. Check the vendor's note before planning work around an entry.
The notion-fetch MCP tool's self response now includes a current_tool_access map showing which tools are available on the workspace's plan before making calls.
User objects now include email_verified boolean, and Notion MCP token responses include user_id, workspace_id, and email_domain fields for better connection identification.
API-generated links for pages, databases, and data sources now use notion.com domain instead of notion.so, with URLs formatted as https://app.notion.com/p/{page-id}.
Search endpoint now accepts filter.in_trash option to list trashed items, and Query data source accepts is_archived parameter for archived pages.
Notion MCP access tokens now last about eight hours instead of one hour.
SDK v5.23.0 now automatically retries HTTP 529 service_overload responses with Retry-After header respect.
New SDK helpers iterateAllDataSourceRows() and collectAllDataSourceRows() enable pagination beyond the 10,000 result limit for large data sources.
notion.asyncTasks.retrieve() and allow_async parameter enable asynchronous large markdown writes with polling.
New verifyWebhookSignature() helper in SDK v5.23.0 simplifies webhook authentication verification.
You can now create HTML blocks by uploading .html files and attaching them to embed blocks via embed.file_upload.
When creating personal access tokens, users can now select expiration periods of 7, 30, 90, 180 days or 1 year instead of fixed 1 year.
databases.retrieve now returns the icon set in Notion UI, matching data source icon behavior.
Icon name field now accepts icon picker names like 'token' and 'star circle', and databases.retrieve now returns the UI icon.
Create and update page markdown endpoints now accept allow_async: true for large requests that return async_task handles for polling.
notion-fetch MCP tool now accepts special id 'self' to return connected workspace and user identity without extra API calls.
New MCP tool for polling the status of async tasks started by other tools like notion-duplicate-page or notion-create-pages, returning queued/running/retrying/succeeded/failed status.
Business plan teams with Notion AI can now query single databases/views directly from AI assistants, previously requiring Enterprise plan.
All plans now see the same MCP tools with clear upgrade messages instead of hidden tools; notion-query-data-sources now available on Business plans (previously Enterprise only).
Business + Notion AI plans can now query single databases from AI assistants; status property options now support optional group field assignment.
Status property options now accept optional group field to assign options to 'To-do', 'In progress', or 'Complete' groups.
Notion API now applies rate limits per workspace in addition to per-connection limits, scaled to workspace plan.
Bots can now be assigned to people properties and referenced in user rich text mentions.
New public connections now mint fresh access_token and refresh_token for each OAuth authorization instead of reusing existing tokens.
Update page markdown endpoint now supports `insert_content.position` to prepend or append content without rewriting full page.
New Developer portal provides single place to manage connections, Workers, and personal access tokens with workspace admin PAT management.
Pages and blocks parented by an agent now serialize with parent type 'agent_id' instead of being rejected or rewritten.
New POST /v1/blocks/meeting_notes/query endpoint returns AI meeting notes with optional filters, sorts, and limits.
Query data source pagination cursors now embed session identifiers to eliminate intermittent validation errors from overlapping pagination sessions.
Query data source pagination cursors now embed session identifiers to eliminate validation errors from overlapping pagination sessions.
Query endpoints now enforce maximum pagination depth of 10,000 results per query with new request_status field indicating incomplete results.
Create and update comment endpoints now explicitly document that markdown parameter supports only inline formatting, not structured blocks.
Database and data source filters now accept arrays of values for equals/does_not_equal on select/status and contains/does_not_contain on multi_select.
MCP search, fetch, and markdown tools improved with better Slack integration, domain handling, archive indicators, and CIMD OAuth support.
Update a comment (PATCH /v1/comments/:comment_id) and Delete a comment (DELETE /v1/comments/:comment_id) endpoints are now generally available.
Create comment endpoint now accepts optional markdown string parameter as alternative to rich_text; exactly one must be provided.
Developer Terms updated with clarifications to scope, revisions to Feedback provision, and other minor changes.
heading_4 is now a supported block type alongside heading_1, heading_2, and heading_3.
People filter conditions now accept 'me' value for contains and does_not_contain, resolving to authorized user for public integrations.
Date filter conditions now accept relative date values: 'today', 'tomorrow', 'yesterday', 'one_week_ago', 'one_week_from_now', 'one_month_ago', 'one_month_from_now'.
Paragraph blocks that are direct children of tab blocks now support optional icon field when creating or updating tabs.
Fixed percent-encoded property IDs in view filters, rejected width: 0 for columns, and fixed partial properties list behavior.
Fixes for percent-encoded property IDs resolution, minimum column width enforcement (minimum 1), and partial properties list visibility in views.
Native Notion icons now return as type: 'icon' with name and color; new List custom emojis endpoint retrieves workspace custom emojis.
Tab blocks are now supported for reading and creating; each tab is a paragraph block with nested children and optional icon.
Verification property on wiki database pages can now be set and updated via Create/Update page endpoints.
Status properties now creatable and updatable via API and MCP; specify {status: {}} with optional custom options in Create database/data source requests.
Status properties can now be created and updated through the API with custom options, previously read-only.
Eight new endpoints for programmatic view management: create, retrieve, update, delete views; list views; and query views with pagination support.
Eight new endpoints enable programmatic management of database views including create, retrieve, update, delete, list, and query operations.
Update page markdown endpoint now supports update_content and replace_content command types for targeted edits.
API version 2026-03-11 replaces 'after' with 'position', 'archived' with 'in_trash', and renames 'transcription' to 'meeting_notes' block type.
New MCP tools for creating and updating database views with full configuration support including filters, sorts, and layout-specific settings.
Create and update page endpoints now accept optional timezone field in template parameter to control template variable resolution.
GET /v1/pages/:page_id/markdown endpoint now available to internal integrations, previously public-only.
Markdown retrieval endpoint supports `include_transcript` parameter; new transcription block type for reading AI meeting notes metadata.
Three new endpoints (POST /v1/pages with markdown, GET /v1/pages/:page_id/markdown, PATCH /v1/pages/:page_id/markdown) enable page content management using enhanced markdown.
Multiple MCP enhancements including block comments, Notion Sites support, meeting transcripts, data source queries, schema optimization, and enterprise governance.
JavaScript/TypeScript SDK now retries failed requests automatically with configurable backoff.
New List data source templates endpoint and template parameter in Create/Update page endpoints for page template support.
New endpoint to list available templates for creating data sources.
New endpoint to change the parent of an existing page.
Tool consolidation removed notion-get-user, fixed delete bug with replace_content, and reduced context tokens.
Update page endpoint now supports erase_content parameter to remove content from pages.
Support added for customizing the position of a new page within the parent page when creating pages.
Remove page_id as possible parent for CreateDataSourceBodyParameters; only database_id now supported.
JavaScript/TypeScript SDK dataSource.update now supports changing data source parent database.
JavaScript/TypeScript SDK adds is_locked boolean parameter support on update page and database APIs.
Major API version introduces separation of databases (containers) from data sources (tables) enabling multi-source databases.
Developer Terms revised to refine scope application and clarify prohibited API uses with new formatting section.
Newly generated Public API tokens now use ntn_ prefix instead of secret_ prefix for improved security scanning compatibility.
New in_trash property added to indicate if pages/blocks/databases are in trash; deprecated archived field may be removed in future version.
Support added for reading and writing names to file blocks in the public API.
We watch Notion because we run integrations on it. If one of yours depends on Notion, we can take it over: build it properly, operate it, and fix it when Notion changes, before your data is affected. Fixed-price scoping quote within 48 hours.