@notionhq/client 5.0.0-rc.0

v5.0.0-rc.0

on Node.js NPM

🚀 Release Candidate Changelog

Major changes and highlights from v4.0.2 to v5.0.0-rc.0.

⚡️ Major API and SDK updates

• Support for multiple data sources
  • Prepared the SDK for Notion API version 2025-09-03, introducing notion.dataSources.* endpoints to manage databases at the data source level and repurposing notion.databases.* endpoints for the database container. #600 #601 #602 #603
• Pinned v5 pre-release
  • Version bumped to premajor v5.0.0-rc.0 to reflect breaking and additive changes. #600
• Removed support for `notion.databases.list
  • The list databases method has been removed, since this endpoint has been deprecated & unsupported since 2022-02-22, and v5 of the SDK is tailored toward 2025-09-03 #600

📝 API shape and type improvements

• Richer API error details
  • SDK now surfaces the optional additional_data field in API error responses for better diagnostics. #603
• API schema syncs
  • DataSourceObjectResponse["parent"] now supports the data_source_id variant.
  • Search filter enum updated from page | database to page | data_source.
  • Typechecking added for all examples/ projects in CI. #602

🧩 Examples and internal maintenance

• Examples directory
  • Migrated all examples/ to TypeScript and committed missing build files. #603 #600
• CI improvements
  • All examples are now typechecked as part of continuous integration. #602

🛠 Miscellaneous fixes

• Documentation
  • Updated the minimum recommended TypeScript version in the README after a dependency upgrade. #598
• Patch releases
  • Version bumps and lockfile updates to keep publish and infra consistent. #596 #597

Full Changelog: f12b584...178b3c0

Upgrade Guide: https://developers.notion.com/docs/upgrade-guide-2025-09-03