Updates theΒ properties
Β of a page in a database. TheΒ properties
Β body param of this endpoint can only be used to update theΒ properties
Β of a page that is a child of a database. The pageβsΒ properties
Β schema must match the parentΒ databaseβs properties.
This endpoint can be used to update any pageΒ icon
Β orΒ cover
, and can be used toΒ delete
Β or restore any page.
To add page content instead of page properties, use the append block children endpoint. The page_id
can be passed as the block_id
when adding block children to the page.
Returns the updated page object.
Requirements
Your integration must have update content capabilities on the target page in order to call this endpoint. To update your integrations capabilities, navigation to the My integrations dashboard, select your integration, go to the Capabilities tab, and update your settings as needed.
Attempting a query without update content capabilities returns an HTTP response with a 403 status code.
Limitations
- Updating rollup property values is not supported.
- A pageβs
parent
cannot be changed.
Errors
Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.