Pages

Update page

Changed on
patch/v1/pages/{page_id}

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/pages/{page_id}
  • Auth
    HTTP bearer

Path parameters

page_idstring required

Query parameters

filter_propertiesstring[]

Property names or IDs to include in each page's properties object. Other properties are left out. Repeat the parameter to pass more than one value, for example filter_properties=title&filter_properties=Status. Pages that aren't in a data source always return only title.

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body

propertiesobject
is_lockedboolean

Whether the page should be locked from editing in the Notion app UI. If not provided, the locked state will not be updated.

erase_contentboolean

Whether to erase all existing content from the page. When used with a template, the template content replaces the existing content. When used without a template, simply clears the page content.

in_trashboolean
is_archivedboolean

Example request

{
  "icon": {
    "emoji": "😀"
  },
  "template": {
    "timezone": "America/New_York"
  }
}

Response

OR

Example response

{
  "icon": {
    "emoji": "😀"
  }
}

Changes