| Version | Breaking changes |
|---|---|
2025-09-03 | /v1/databases APIs are re-organized into /v1/data_sources (for managing individual data sources under a database container) and /v1/databases (for managing the database container.)Existing database IDs stay the same, but a new concept of data source IDs is introduced, and required in order to manage data source properties, to support multi-source databases (new in the Notion app as of September 2025.) See changelog and Upgrading to 2025-09-03 guide for more details. |
2022-06-28 | Page properties must be retrieved using the page properties endpoint. Parents are now always direct parents; a parent field has been added to block. Database relations have a type of single_property and dual_property.See changelog for more details. |
2022-02-22 | See changelog. |
2021-08-16 | The Append block children endpoint returns a list of new Block object children instead of the parent block. Array rollup property types changed from file, text and person to files, rich_text and people.Property IDs are now encoded to be URL safe. Empty number, email, select, date, and rollup properties are now returned in page responses as null.More information |
2021-05-13 | Rich text property values use the type rich_text instead of text.Migration details |