Changelog

We released v5.1.0 of @notionhq/client, our SDK for JavaScript and TypeScript. This includes the following fixes and improvements:

• Add support for is_locked boolean parameter on update page and database APIs (to update whether a page is locked in the Notion app UI)
• dataSource.update: add support for changing a data source’s parent database
• Remove page_id as a possible parent for CreateDataSourceBodyParameters
• Add request_id to Client log lines

📣 Important API update coming September 3rd

We’re introducing multi-source databases to Notion! Our new API version 2025-09-03 separates “databases” (containers) from “data sources” (tables), unlocking powerful new organizational capabilities.

What you need to know

• Revised Section 1.1 to refine the scope of application of the Developer Terms.
• Revised Section 3.1 to clarify prohibited uses of the API and created a new Section 3.2 for formatting purposes

What’s New?

We are excited to announce an update to our Notion Public API token format.

Starting September 25, 2024, newly generated Public API tokens will automatically use the ntn_ prefix instead of the secret_ prefix.

Why the Change?

• Revised Section 3.1 of the Developer Terms to include additional security and data use restrictions.

• Added: New property in_trash to indicate whether a page/block/database has been deleted or placed in “Trash”.
• Support: Both archived and in_trash properties are fully supported. Contact developer support for help during this transition or reach out in our Notion Devs Slack group.

• We added support for reading and writing names to file blocks in the public API. Read more here.
• We fixed the types in the SDK to support appending table and column blocks as children of toggle blocks.
• We updated the emoji and timezones available in the SDK.
• We added support for australian_dollar in the format field of number database properties.

• The Examples page was updated with all our most recent demo code. We’ve organized these sample integrations by level of experience with the Public API to help developers who are newer to the Public API find introductory code more easily.
• A note was added to all API endpoint documentation directing developers to review the Status codes page for a complete list of error codes that can be returned by API requests.
• A clarification was added to the Request limits page and Append block children endpoint documentation to indicate the current limit for appending a list of block children per API request. Up to 100 block children can be appended at a time.

The updates related to the Formulas 2.0 launch are now live in the Public API. These changes will not impact most developers using the Public API; however, please note that the formatting of formula.expression, which is returned when retrieving a database with a Formula property, has changed. See Notion’s Help Center articles for more information on the Formula 2.0 changes: