dusk bot
integrationsreplace page content

dusk botintegrationsnotion

review a notion rewrite before replacing its blocks

see the whole rewrite before the old checklist goes. this action replaces a notion page's child blocks and offers a dry run first. it can also make a backup.

by the dusk bot team · checked · how we made this

some blocks and nested content stay out of that backup, and a staged replacement can fail halfway. use the preview to decide whether a full rewrite is worth it.

pixel art: a pink pixel bot and a green pixel bot beside the Notion mark on a white tile, a notebook and a shield with a tick, on a lemon field in front of little green islands on a lake, one saying "preview before replacing"

replace page content (with backup), in plain words

use replacement when the old body really should go. give the bot the page and new text. a dry run shows what it would remove and add without doing it.

it normally archives the old children, then adds the new ones in batches. an optional backup isn't a complete copy of every page structure. inspect complex pages before trusting this route.

a routine to copy

paste this into a chat with your bot

on the last wednesday of each month at 14:35, read the cinderbrook equipment checklist in notion. compare it with the latest file in the approved checklists project folder. if the contents match, stay quiet. otherwise run a dry preview and report the blocks affected here. ask me before you change anything. stop if nested content, toggles or sub-pages make the backup incomplete. after i approve, make a backup and replace only that page. report partial failures and never retry blindly.
when
last wednesday of the month at 14:35
needs
access to the approved checklists project folder; notion read and write for inspecting, previewing and replacing the chosen page

what comes back looks like this (an example)

cinderbrook checklist preview
- current body: flat checklist blocks
- proposed body: new opening and closing checks
- backup: required before an approved replacement

dry run only. existing page unchanged.

good jobs for it

  • equipment checks: replace a flat checklist with the new version you approved.
  • event instructions: update a simple page after the venue agrees to the procedure.
  • a rewrite decision: preview the full replacement and decide if small additions would do.

before it runs

dusk bot counts Replace page content (with backup) as a change: it alters something in Notion, and the sending setting does not cover it. a bot you allow only to read can never call it.

the permissions Notion asks for to run it: insert_content, read_content, update_content.

how to start

  1. limit the access. allow notion read and write for this replacement job.
  2. read before rewriting. link the page and have the bot inspect its current contents.
  3. require a dry run. read the proposed removals and additions. tell it to wait before making a backup or replacement.
  4. inspect both copies. after an approved run, read the new page and backup side by side. pause at any partial failure.

limits worth knowing

  • a half-finished rewrite needs inspection. old text can go before all the new text arrives. stop, look at what remains and avoid a blind retry.
  • keeping old children adds alongside them. turn off archiving only when that is the result you want.

the details it works from

inputrequiredwhat it is
page_idyesThe unique identifier (UUID) of the page whose content will be replaced.
new_childrenyesArray of block objects to append to the page after clearing existing content.
dry_runnoIf True, returns what would be deleted and appended without making any changes.
backup_parentnoParent specification for backup page creation.
create_backupnoWhether to create a backup page with the current content before replacing it.
backup_title_suffixnoSuffix to append to the original page title when creating a backup page.

from composio's catalog for Notion (action NOTION_REPLACE_PAGE_CONTENT, read 12 november 20264). your bot fills these in from what you tell it.

try it in 2 minutes

  1. link one simple notion page
  2. give the replacement text from a file
  3. request a dry run only
  4. read the proposed removals and what the backup leaves out

quick checklist

  • the right page is open
  • the preview shows the intended removals and additions
  • nested content will not disappear unnoticed
  • i understand the backup limits
  • partial failure means stop and inspect

mistakes people make

treating backup as a full restore

inspect nested content and unsupported blocks first.

retrying a half-finished replacement

open the page and identify what remains before another write.

questions

can i see what would change without rewriting the page?

yes. ask for a dry run. it previews removals and additions while leaving the page alone.

does a backup guarantee a full restore?

a backup covers only the content this action can copy. unsupported blocks and nested content need another plan. leave a complex page alone if losing those parts would break it.

sources

  1. dusk bot docs: files and apps
  2. dusk bot docs: routines
  3. dusk bot docs: computer permissions
  4. composio, Notion toolkit (catalog version 20261101_00), checked 12 november 2026

drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].