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.
Limitations
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
.
Success
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.
Errors
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
.