Actions14
Database Page → Update
AI-generatedSummary
Update a Notion database page's properties and icon.
Inputs
- pageId (required) — The Notion Database Page to update. Accepts a valid Notion URL or a page ID (8-4-4-4-12 hex format). Mode 'url' validates and extracts from a Notion page link; mode 'id' accepts the raw ID string.
- simple — Whether to return a simplified version of the response instead of the raw data. Defaults to true.
- propertiesUi — Fixed collection configuring property values to update on the database page. Supports multiple entries, each with a key (property name/ID), type (hidden, derived from key), text mode (simpleText, richText, JSON), and value inputs including simple text, rich text with annotations, or raw JSON. Load options for keys depend on pageId.
- options — Collection for icon and metadata options. iconType selects 'emoji' or 'file'; icon provides the emoji character or file URL for the database page icon.
Output shape
Returns the updated Notion page object. When simple is true, a simplified structure is returned; otherwise the raw API response is returned.
The operation sends a PATCH request to the Notion API to update the specified page's properties and optional icon. All property changes are defined via the propertiesUi collection.
Examples
Example 1: Update a page's title and set an emoji icon.
pageId: database page URL; simple: true; propertiesUi: [key=title, type=title, textContent=New Title]; options: iconType=emoji, icon=:smiley: