Update Block

notion.update_block

ActionBusiness appsconnection required

Calls the Notion API with the connection's credentials.

Update a block's content, or archive and restore it.

Ask about Notion All Notion nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: API key
Providers: Notion
Secret shape: the integration token, or {"token": "…"}
Resolved by: config.connection_id, else node.connection_id

Configuration

3 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
block_id Id of the block to update.	string	Yes	—	—	—
block The patch keyed by the block's own type, e.g. {"paragraph": {"rich_text": [{"type": "text", "text": {"content": "hi"}}]}}.	object	No	—	≥ 1 characters	{"paragraph":{"rich_text":[{"text":{"content":"hi"},"type":"text"}]}}
archived True moves the block to the trash, false restores it.	boolean	No	—	—	—

At least one of archived, block must be set.

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "block": {
    "paragraph": {
      "rich_text": [
        {
          "text": {
            "content": "hi"
          },
          "type": "text"
        }
      ]
    }
  }
}

Output

One shape.

result

Field	Type	Example
ok True when Notion accepted the update.	boolean	true
block_id Id of the updated block.	string	—
type The block's type, as Notion reports it.	string	—

{
  "block_id": "",
  "ok": true,
  "type": ""
}

Notes

A block cannot change type: the key in 'block' must be its current type.

Related Notion nodes

Templates that use Notion

See Update Block run in a workflow.

In a technical demo we add the Notion connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales