Changes for May 9 - 22, 2022

Bug fixes and performance improvements

Link Preview APIs

Today we’re excited to launch a new set of APIs for developers to build on — link previews APIs. Over the past six months, we launched link previews with tools like Slack, Trello, Figma, and Asana, allowing users to preview authenticated content in a new structured block. Now, we’re ready for any developer to build integrations that support link previews in Notion.

Changes for April 25 - May 9, 2022

Read about our new changes below.

Changes for April 11 - 24, 2022

Read about our new changes below.

Changes for March 28 - April 10, 2022

There was a company-wide product bug bash! As a result nothing API-specific to share for these 2 weeks, but we've been hard at work improving test coverage and paring down tech debt.

Changes for March 14 - 27, 2022

Read about our new changes below.

Query a database endpoint supports filtering by timestamp

When querying a database using filters, you previously were only able to build filters using properties that were explicitly defined in the database schema. We've added a new type of filter for the created timestamp and last edited timestamp of any page within the database. This means you can filter by these attributes, even if the database doesn't have a "Created time" or "Last edited time" property.

Changes for February 28, 2022 - March 13, 2022

Read about our new changes.

Block colors are now supported in the API

We have added support for block colors in the Notion Public API. There is now a color keyword for the following block types: paragraph, heading_1, heading_2, heading_3, bulleted_list_item, numbered_list_item, to_do, toggle, callout, quote, and table_of_contents. For these block types, the block color is returned in the block object, and you can use the update block, append block children, and create page endpoints to update the color of existing blocks and create new blocks with color.

Updated Developers Terms

With the API officially out of beta, Notion has updated our developer terms of service as of March 1st, 2022. View our updated terms here.