https://seamless.engineering/api-changelog/notion/ Every Notion API change our daily monitoring detects: breaking changes, deprecations and additions. en Sat, 10 Oct 2026 00:10:15 GMT 720 https://seamless.engineering/api-changelog/notion/#dde19e4c1b57 notion-dde19e4c1b57 Wed, 22 Jul 2026 12:00:00 GMT Other Other (2026-07-14). Notion MCP access tokens now last about eight hours instead of one hour. https://seamless.engineering/api-changelog/notion/#3488cfd81015 notion-3488cfd81015 Wed, 22 Jul 2026 12:00:00 GMT New feature New feature (2026-07-15). 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. https://seamless.engineering/api-changelog/notion/#522acbef8898 notion-522acbef8898 Wed, 22 Jul 2026 12:00:00 GMT Breaking Breaking (2026-07-15). 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}. https://seamless.engineering/api-changelog/notion/#e868656fd2fd notion-e868656fd2fd Wed, 22 Jul 2026 12:00:00 GMT New feature New feature (2026-07-17). 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. https://seamless.engineering/api-changelog/notion/#ff83403ade3c notion-ff83403ade3c Wed, 22 Jul 2026 12:00:00 GMT New feature New feature (2026-07-15). Search endpoint now accepts filter.in_trash option to list trashed items, and Query data source accepts is_archived parameter for archived pages. https://seamless.engineering/api-changelog/notion/#0628b5662e83 notion-0628b5662e83 Wed, 08 Jul 2026 12:00:00 GMT Bug fix Bug fix (2026-07-08). SDK v5.23.0 now automatically retries HTTP 529 service_overload responses with Retry-After header respect. https://seamless.engineering/api-changelog/notion/#a9d929e71d42 notion-a9d929e71d42 Wed, 08 Jul 2026 12:00:00 GMT New feature New feature (2026-07-08). New SDK helpers iterateAllDataSourceRows() and collectAllDataSourceRows() enable pagination beyond the 10,000 result limit for large data sources. https://seamless.engineering/api-changelog/notion/#210b7a31b8b1 notion-210b7a31b8b1 Wed, 08 Jul 2026 12:00:00 GMT New feature New feature (2026-07-08). notion.asyncTasks.retrieve() and allow_async parameter enable asynchronous large markdown writes with polling. https://seamless.engineering/api-changelog/notion/#62adc9254908 notion-62adc9254908 Wed, 08 Jul 2026 12:00:00 GMT New feature New feature (2026-07-08). New verifyWebhookSignature() helper in SDK v5.23.0 simplifies webhook authentication verification. https://seamless.engineering/api-changelog/notion/#a1419a3af9a0 notion-a1419a3af9a0 Fri, 03 Jul 2026 12:00:00 GMT New feature New feature (2026-06-22). Business + Notion AI plans can now query single databases from AI assistants; status property options now support optional group field assignment. https://seamless.engineering/api-changelog/notion/#e9fde1ff6f6c notion-e9fde1ff6f6c Fri, 03 Jul 2026 12:00:00 GMT New feature New feature (2026-07-03). You can now create HTML blocks by uploading .html files and attaching them to embed blocks via embed.file_upload. https://seamless.engineering/api-changelog/notion/#ccd03161b961 notion-ccd03161b961 Thu, 02 Jul 2026 12:00:00 GMT New feature New feature (2026-07-01). databases.retrieve now returns the icon set in Notion UI, matching data source icon behavior. https://seamless.engineering/api-changelog/notion/#4af6fddc1cc9 notion-4af6fddc1cc9 Thu, 02 Jul 2026 12:00:00 GMT New feature New feature (2026-07-01). Icon name field now accepts icon picker names like 'token' and 'star circle', and databases.retrieve now returns the UI icon. https://seamless.engineering/api-changelog/notion/#47441114e51c notion-47441114e51c Thu, 02 Jul 2026 12:00:00 GMT New feature New feature (2026-07-02). 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. https://seamless.engineering/api-changelog/notion/#72d48e629ed5 notion-72d48e629ed5 Wed, 01 Jul 2026 12:00:00 GMT New feature New feature (2026-06-29). Create and update page markdown endpoints now accept allow_async: true for large requests that return async_task handles for polling. https://seamless.engineering/api-changelog/notion/#606f759d4601 notion-606f759d4601 Fri, 26 Jun 2026 12:00:00 GMT New feature New feature (2026-06-22). Business plan teams with Notion AI can now query single databases/views directly from AI assistants, previously requiring Enterprise plan. https://seamless.engineering/api-changelog/notion/#c64cdbfe374b notion-c64cdbfe374b Fri, 26 Jun 2026 12:00:00 GMT New feature New feature (2026-06-25). notion-fetch MCP tool now accepts special id 'self' to return connected workspace and user identity without extra API calls. https://seamless.engineering/api-changelog/notion/#d01b2c726080 notion-d01b2c726080 Fri, 26 Jun 2026 12:00:00 GMT New feature New feature (2026-03-19). Status properties can now be created and updated through the API with custom options, previously read-only. https://seamless.engineering/api-changelog/notion/#39a5664bcac6 notion-39a5664bcac6 Thu, 25 Jun 2026 12:00:00 GMT New feature New feature (2026-06-25). 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. https://seamless.engineering/api-changelog/notion/#82b7b28481db notion-82b7b28481db Tue, 23 Jun 2026 12:00:00 GMT New feature New feature (2026-06-22). 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). https://seamless.engineering/api-changelog/notion/#824955ec9296 notion-824955ec9296 Tue, 23 Jun 2026 12:00:00 GMT New feature New feature (2026-06-22). Status property options now accept optional group field to assign options to 'To-do', 'In progress', or 'Complete' groups. https://seamless.engineering/api-changelog/notion/#18f5c60b7995 notion-18f5c60b7995 Wed, 17 Jun 2026 12:00:00 GMT Other Other (2026-06-16). Notion API now applies rate limits per workspace in addition to per-connection limits, scaled to workspace plan. https://seamless.engineering/api-changelog/notion/#c0b6663b494b notion-c0b6663b494b Wed, 10 Jun 2026 12:00:00 GMT New feature New feature (2026-06-10). Bots can now be assigned to people properties and referenced in user rich text mentions. https://seamless.engineering/api-changelog/notion/#79e7df4bf379 notion-79e7df4bf379 Mon, 08 Jun 2026 12:00:00 GMT Breaking Breaking (2026-06-08). New public connections now mint fresh access_token and refresh_token for each OAuth authorization instead of reusing existing tokens. https://seamless.engineering/api-changelog/notion/#b83b7ebb356a notion-b83b7ebb356a Sun, 24 May 2026 12:00:00 GMT Other Other (2024-12-20). Developer Terms revised to refine scope application and clarify prohibited API uses with new formatting section. https://seamless.engineering/api-changelog/notion/#f2de9dd206cc notion-f2de9dd206cc Sun, 24 May 2026 12:00:00 GMT New feature New feature (2026-01-15). New endpoint to list available templates for creating data sources. https://seamless.engineering/api-changelog/notion/#9fc114bb078b notion-9fc114bb078b Sun, 24 May 2026 12:00:00 GMT Bug fix Bug fix (2026-04-22). Query data source pagination cursors now embed session identifiers to eliminate validation errors from overlapping pagination sessions. https://seamless.engineering/api-changelog/notion/#906705a872d9 notion-906705a872d9 Sun, 24 May 2026 12:00:00 GMT Breaking Breaking (2025-09-13). Remove page_id as possible parent for CreateDataSourceBodyParameters; only database_id now supported. https://seamless.engineering/api-changelog/notion/#432a4dc71196 notion-432a4dc71196 Sat, 16 May 2026 12:00:00 GMT New feature New feature (2026-05-15). Update page markdown endpoint now supports `insert_content.position` to prepend or append content without rewriting full page. https://seamless.engineering/api-changelog/notion/#cd9742396f47 notion-cd9742396f47 Thu, 14 May 2026 12:00:00 GMT Bug fix Bug fix (2026-03-30). Fixes for percent-encoded property IDs resolution, minimum column width enforcement (minimum 1), and partial properties list visibility in views. https://seamless.engineering/api-changelog/notion/#d2afe4a381e6 notion-d2afe4a381e6 Wed, 13 May 2026 12:00:00 GMT New feature New feature (2026-03-19). Eight new endpoints enable programmatic management of database views including create, retrieve, update, delete, list, and query operations. https://seamless.engineering/api-changelog/notion/#462160758e3c notion-462160758e3c Tue, 12 May 2026 12:00:00 GMT New feature New feature (2026-05-11). Pages and blocks parented by an agent now serialize with parent type 'agent_id' instead of being rejected or rewritten. https://seamless.engineering/api-changelog/notion/#422add2dba21 notion-422add2dba21 Tue, 12 May 2026 12:00:00 GMT New feature New feature (2026-05-12). New Developer portal provides single place to manage connections, Workers, and personal access tokens with workspace admin PAT management. https://seamless.engineering/api-changelog/notion/#a37578167d3a notion-a37578167d3a Tue, 12 May 2026 12:00:00 GMT New feature New feature (2026-05-11). New POST /v1/blocks/meeting_notes/query endpoint returns AI meeting notes with optional filters, sorts, and limits. https://seamless.engineering/api-changelog/notion/#cb90ebf5f5b3 notion-cb90ebf5f5b3 Thu, 23 Apr 2026 12:00:00 GMT Bug fix Bug fix (2026-04-22). Query data source pagination cursors now embed session identifiers to eliminate intermittent validation errors from overlapping pagination sessions. https://seamless.engineering/api-changelog/notion/#42d679dc1556 notion-42d679dc1556 Tue, 21 Apr 2026 12:00:00 GMT Breaking Breaking (2026-04-20). Query endpoints now enforce maximum pagination depth of 10,000 results per query with new request_status field indicating incomplete results. https://seamless.engineering/api-changelog/notion/#2c6aaae10b71 notion-2c6aaae10b71 Sat, 18 Apr 2026 12:00:00 GMT Other Other (2026-04-17). Create and update comment endpoints now explicitly document that markdown parameter supports only inline formatting, not structured blocks. https://seamless.engineering/api-changelog/notion/#7f2c81a8e790 notion-7f2c81a8e790 Sat, 18 Apr 2026 12:00:00 GMT New feature New feature (2026-04-17). 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. https://seamless.engineering/api-changelog/notion/#a007b00816bb notion-a007b00816bb Sat, 18 Apr 2026 12:00:00 GMT New feature New feature (2026-04-17). MCP search, fetch, and markdown tools improved with better Slack integration, domain handling, archive indicators, and CIMD OAuth support. https://seamless.engineering/api-changelog/notion/#ce4e97b8e366 notion-ce4e97b8e366 Sat, 18 Apr 2026 12:00:00 GMT New feature New feature (2026-04-17). Update a comment (PATCH /v1/comments/:comment_id) and Delete a comment (DELETE /v1/comments/:comment_id) endpoints are now generally available. https://seamless.engineering/api-changelog/notion/#f8d2bd8170bc notion-f8d2bd8170bc Wed, 08 Apr 2026 12:00:00 GMT New feature New feature (2026-04-07). Create comment endpoint now accepts optional markdown string parameter as alternative to rich_text; exactly one must be provided. https://seamless.engineering/api-changelog/notion/#32dda4f72431 notion-32dda4f72431 Fri, 03 Apr 2026 12:00:00 GMT Other Other (2026-04-02). Developer Terms updated with clarifications to scope, revisions to Feedback provision, and other minor changes. https://seamless.engineering/api-changelog/notion/#3f1a731ab741 notion-3f1a731ab741 Tue, 31 Mar 2026 12:00:00 GMT New feature New feature (2026-03-30). heading_4 is now a supported block type alongside heading_1, heading_2, and heading_3. https://seamless.engineering/api-changelog/notion/#2f401d896971 notion-2f401d896971 Tue, 31 Mar 2026 12:00:00 GMT New feature New feature (2026-03-30). People filter conditions now accept 'me' value for contains and does_not_contain, resolving to authorized user for public integrations. https://seamless.engineering/api-changelog/notion/#1d24fa58e82a notion-1d24fa58e82a Tue, 31 Mar 2026 12:00:00 GMT New feature New feature (2026-03-30). 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'. https://seamless.engineering/api-changelog/notion/#0943aaa13503 notion-0943aaa13503 Tue, 31 Mar 2026 12:00:00 GMT New feature New feature (2026-03-30). Paragraph blocks that are direct children of tab blocks now support optional icon field when creating or updating tabs. https://seamless.engineering/api-changelog/notion/#cd9742396f47 notion-cd9742396f47 Tue, 31 Mar 2026 12:00:00 GMT Bug fix Bug fix (2026-03-30). Fixed percent-encoded property IDs in view filters, rejected width: 0 for columns, and fixed partial properties list behavior. https://seamless.engineering/api-changelog/notion/#af0be4457080 notion-af0be4457080 Mon, 30 Mar 2026 12:00:00 GMT New feature New feature (2026-01-15). Tool consolidation removed notion-get-user, fixed delete bug with replace_content, and reduced context tokens. https://seamless.engineering/api-changelog/notion/#063bf1cde6b6 notion-063bf1cde6b6 Mon, 30 Mar 2026 12:00:00 GMT New feature New feature (2026-01-15). Update page endpoint now supports erase_content parameter to remove content from pages. https://seamless.engineering/api-changelog/notion/#424ce35b31bb notion-424ce35b31bb Sun, 29 Mar 2026 12:00:00 GMT New feature New feature (2026-01-15). Support added for customizing the position of a new page within the parent page when creating pages. https://seamless.engineering/api-changelog/notion/#16cf71b884d6 notion-16cf71b884d6 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature (2026-02-26). JavaScript/TypeScript SDK now retries failed requests automatically with configurable backoff. https://seamless.engineering/api-changelog/notion/#49bcaae84121 notion-49bcaae84121 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature (2025-09-13). JavaScript/TypeScript SDK dataSource.update now supports changing data source parent database. https://seamless.engineering/api-changelog/notion/#e2ef355942d1 notion-e2ef355942d1 Sun, 29 Mar 2026 12:00:00 GMT New feature New feature (2025-09-13). JavaScript/TypeScript SDK adds is_locked boolean parameter support on update page and database APIs. https://seamless.engineering/api-changelog/notion/#0a16fe6e7703 notion-0a16fe6e7703 Fri, 27 Mar 2026 12:00:00 GMT New feature New feature (2026-02-26). Multiple MCP enhancements including block comments, Notion Sites support, meeting transcripts, data source queries, schema optimization, and enterprise governance. https://seamless.engineering/api-changelog/notion/#7c7beac4bf20 notion-7c7beac4bf20 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-02-26). Markdown retrieval endpoint supports `include_transcript` parameter; new transcription block type for reading AI meeting notes metadata. https://seamless.engineering/api-changelog/notion/#de00654a7b31 notion-de00654a7b31 Thu, 26 Mar 2026 12:00:00 GMT Breaking Breaking (2025-08-26). Major API version introduces separation of databases (containers) from data sources (tables) enabling multi-source databases. https://seamless.engineering/api-changelog/notion/#9056b30c4351 notion-9056b30c4351 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-01-15). New List data source templates endpoint and template parameter in Create/Update page endpoints for page template support. https://seamless.engineering/api-changelog/notion/#b63cf0c247b5 notion-b63cf0c247b5 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2023-12-10). Support added for reading and writing names to file blocks in the public API. https://seamless.engineering/api-changelog/notion/#1893231e2cbf notion-1893231e2cbf Thu, 26 Mar 2026 12:00:00 GMT Deprecation Deprecation (2024-04-01). New in_trash property added to indicate if pages/blocks/databases are in trash; deprecated archived field may be removed in future version. https://seamless.engineering/api-changelog/notion/#3468ce75a06b notion-3468ce75a06b Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-02-26). 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. https://seamless.engineering/api-changelog/notion/#84a22401268e notion-84a22401268e Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-11). Update page markdown endpoint now supports update_content and replace_content command types for targeted edits. https://seamless.engineering/api-changelog/notion/#595c46687b48 notion-595c46687b48 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-02). GET /v1/pages/:page_id/markdown endpoint now available to internal integrations, previously public-only. https://seamless.engineering/api-changelog/notion/#b6e5c2f6b470 notion-b6e5c2f6b470 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-01-15). New endpoint to change the parent of an existing page. https://seamless.engineering/api-changelog/notion/#686ff7ed5e0e notion-686ff7ed5e0e Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-25). Native Notion icons now return as type: 'icon' with name and color; new List custom emojis endpoint retrieves workspace custom emojis. https://seamless.engineering/api-changelog/notion/#54aea1bbd69c notion-54aea1bbd69c Thu, 26 Mar 2026 12:00:00 GMT Other Other (2024-09-11). Newly generated Public API tokens now use ntn_ prefix instead of secret_ prefix for improved security scanning compatibility. https://seamless.engineering/api-changelog/notion/#0535eeaec64b notion-0535eeaec64b Thu, 26 Mar 2026 12:00:00 GMT Breaking Breaking (2026-03-11). API version 2026-03-11 replaces 'after' with 'position', 'archived' with 'in_trash', and renames 'transcription' to 'meeting_notes' block type. https://seamless.engineering/api-changelog/notion/#49ad26bb2eab notion-49ad26bb2eab Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-11). New MCP tools for creating and updating database views with full configuration support including filters, sorts, and layout-specific settings. https://seamless.engineering/api-changelog/notion/#d01b2c726080 notion-d01b2c726080 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-19). Status properties now creatable and updatable via API and MCP; specify {status: {}} with optional custom options in Create database/data source requests. https://seamless.engineering/api-changelog/notion/#82e4e6d0d3d8 notion-82e4e6d0d3d8 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-25). Tab blocks are now supported for reading and creating; each tab is a paragraph block with nested children and optional icon. https://seamless.engineering/api-changelog/notion/#e80c2aa55e30 notion-e80c2aa55e30 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-11). Create and update page endpoints now accept optional timezone field in template parameter to control template variable resolution. https://seamless.engineering/api-changelog/notion/#d2afe4a381e6 notion-d2afe4a381e6 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-19). Eight new endpoints for programmatic view management: create, retrieve, update, delete views; list views; and query views with pagination support. https://seamless.engineering/api-changelog/notion/#1b8ca104f089 notion-1b8ca104f089 Thu, 26 Mar 2026 12:00:00 GMT New feature New feature (2026-03-25). Verification property on wiki database pages can now be set and updated via Create/Update page endpoints.