releases.shpreview
Notion/SDK (JS)/v5.0.0

v5.0.0

September 3, 2025SDK (JS)View original ↗
$npx -y @buildinternet/releases show rel_purPh-d3rubQ2z8Pdh6Vk

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

[!NOTE] v5.0.0 and 2025-09-03 bring fairly major changes to the SDK and to the API schema!

You can help us by tracking any friction as you upgrade, as well as any issues or improvement opportunities with the JavaScript → TypeScript changes in the examples/ projects, and filing an issue or opening a pull request for each.

New Contributors

Links

Fetched April 3, 2026