What's Changed

• api-endpoints sync: add pagination for ListDataSourceTemplates endpoint by @ksinder in #633
• Bump version to v5.3.0 by @github-actions[bot] in #634

Links

• Full Changelog: v5.2.1...v5.3.0
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.3.0

What's Changed

• Sync api-endpoints: support templates in Update Page by @ksinder in #631

Links

• Full Changelog: v5.2.0...v5.2.1
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.2.1

What's Changed

• API schema sync: small consolidation refactors and fixes by @ksinder in #622
• API schema sync: remove data_source_id type from DataSource.database_parent by @ksinder in #626
• Sync API schema: CreatePage + templates; workspace_id field; query wiki filters by @ksinder in #628
  • Including workspace_id in bot responses alongside workspace_name
  • Introducing a new API endpoint notion.dataSources.listTemplates with one path parameter, data_source_id, for listing the available page templates under a data source
  • Adding a new optional parameter template to CreatePageBodyParameters with polymorphic type options of none (don't apply any template; existing behavior), default (apply data source's default template), and template_id (apply a custom template ID)
  • Adding a new optional parameter result_type to QueryDataSourceBodyParameters to allow for only surfacing "page" or "data_source" result types in the case of wikis (where databases can be nested)

Links

• Full Changelog: 1e9562d...v5.2.0
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.2.0

What's Changed

• Add support for is_locked on update page and database APIs
• Add request_id to Client log lines
• Remove page_id as a possible parent for CreateDataSourceBodyParameters
• SDK dataSource.update: add support for changing parent

Links

• Full Changelog: 6945289...v5.1.0
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.1.0

What's Changed

• Add Notion ID extraction functions to helpers by @riwaht in #606
• Fix some data source issues in Express web form example project by @ksinder in #614
• Sync latest schema: support AND/OR + timestamp filters; misc refactors by @ksinder in #615

New Contributors

• @riwaht made their first contribution in #606

Links

• Full Changelog: e888449...v5.0.1
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.0.1

What's Changed

Major changes and highlights from v4.0.2 to v5.0.0.

⚡️ Major API and SDK updates

• Added 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 #607 #609
• 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
• Added support for verification filters for data sources
  • Added verification filter property to queryDataSources API shape #604

📝 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
• Other
  • Added Copilot instructions file for repo #610

🛠 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

New Contributors

• @hallie made their first contribution in #604

Links

• Full Changelog: f12b584...v5.0.0
• Upgrade Guide: https://developers.notion.com/docs/upgrade-guide-2025-09-03
• NPM Package: https://npmjs.com/package/@notionhq/client/v/5.0.0

What's Changed

• [v5] Bump default Notion-Version to 2025-09-03 by @ksinder in #605
• Add verification filter property to db query by @hallie in #604
• [v5] Data source parent and relation property shape updates by @ksinder in #607

New Contributors

• @hallie made their first contribution in #604

Full Changelog: 178b3c0...v5.0.0-rc.1

NPM link: https://www.npmjs.com/package/@notionhq/client/v/5.0.0-rc.1

🚀 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

What's Changed

• Update Notion JS SDK with GetComment endpoint by @julyou in #595
  • Introduces notion.comments.retrieve({...}) endpoint to fetch a comment by its ID; this was previously a hidden and un-documented endpoint
  • Introduces API shape to manually refresh an API token by passing grant_type: "refresh_token" with a refresh_token to notion.oauth.token(...)
  • Minor refactors and additional type exports
• Bump TypeScript dependency to 5.9 by @ksinder in #597
  • WARNING: This might be effectively a breaking change in some cases since part of the SDK contract is exporting types for Notion's public API endpoints. Before upgrading, confirm your TypeScript version is sufficiently new or that the types are compatible with your system.

Full Changelog: f849574...v4.0.2

View this version on NPM: https://www.npmjs.com/package/@notionhq/client/v/4.0.2

What's Changed

• Support additional headers passed to notion.request()

Full Changelog: f7bfcfd...v4.0.1

View this version on NPM: https://www.npmjs.com/package/@notionhq/client/v/4.0.1