PATCH /v1/pages/{page_id}

Update page properties

Servers

Path parameters

Name Type Required Description
page_id String Yes

The identifier for the Notion page to be updated.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
archived Boolean No
properties Object No

The property values to update for the page. The keys are the names or IDs of the property and the values are property values. If a page property ID is not included, then it is not changed.

properties.title[] Array Yes
properties.title[].text Object Yes
properties.title[].text.content String Yes
properties.title[].text.link Object No
properties.title[].text.link.url String Yes
properties.title[].type String No

Valid values:

  • "text"
properties.type String No

Valid values:

  • "title"
cover Object No

A cover image for the page. Only external file objects are supported.

cover.external Object Yes
cover.external.url String Yes
cover.type String No

Valid values:

  • "external"
in_trash Boolean No

Set to true to delete a block. Set to false to restore a block.

Default value: false

icon Object No

A page icon for the page. Supported types are external file object or emoji object.

icon.emoji String Yes

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.