Description
Previously, the page object returned from page endpoints, as well as the query database and search endpoint, returned a properties field that contained all the page’s properties
along with its value:
"properties": {
"Name": {
"id": "title",
"type": "title",
"title": [
{
"type": "text",
"text": {
"content": "Avocado",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "Avocado",
"href": null
}
]
}
}
While convenient, returning accurate results for all properties resulted in bad performance and timeouts for larger databases or pages with lo
6B4A
ts of mentions. To combat performance, on March 1st, we added a disclaimer that page objects stopped returning accurate results for pages with more than 25 mentions to other objects (which affected properties of type title
, rich_text
, relation
, people
, rollup
, and formula
).
In October 2021, we introduced a way to more accurately retrieve individual page properties via the retrieve a page property item endpoint. With this endpoint, we’re able to paginate complex properties that involve additional look-ups.
With version 2022-06-28
, the type
and property value
from page objects are removed. Thus moving forward, all property value retrieval must happen through the retrieve a page property item endpoint.
"properties": {
"Name": {
"id": "title"
}
}
Notion changelog: https://developers.notion.com/changelog/releasing-notion-version-2022-06-28