📘

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.

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.

Language
Authentication
OAuth2