Update Page Properties

This endpoint is for updating page properties, not page content. To fetch page content, use the retrieve block children endpoint. To append page content, use the append block children endpoint.

Updates page property values for the specified page. Properties that are not set via the properties parameter will remain unchanged.

If the parent is a database, the new property values in the properties parameter must conform to the parent database's property schema.



Updating rollup property values is not supported.

Archive (delete) a page

Set the archived parameter to true to archive or delete a page. For a page that is already archived, you can un-archive or restore that page by making the same request and setting archived to false.


Returns a 200 HTTP response containing the updated page object on success.


Integration capabilities

This endpoint requires an integration to have update content capabilities. Attempting to call this API without update content capabilities will return an HTTP response with a 403 status code. For more information on integration capabilities, see the capabilities guide.


Returns a 404 HTTP response if the page doesn't exist, has been archived, or if the integration doesn't have access to the page.

Returns a 400 or a 429 HTTP response if the request exceeds the request limits.

Returns a 400 HTTP response if the properties body param contains a rollup.

Returns a 400 HTTP response if the has_more value of any property value is true.