Update page
Change a page’s title, content, icon or place. Markdown replaces the whole content. Send the version you read as expectedVersion: if someone saved in between, nothing is written and you get conflict.
/v1/w/{workspace}/pages/{id}Send an Idempotency-Key. This may answer 202 while it waits for approval.
Path parameters
workspacestringrequiredYour workspace’s address name.
idstringrequiredThe page’s id, like pg_…, from List pages.
Headers
Idempotency-Keystring8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.
Body
titlestringA new title.
markdownstringThe content as Markdown: headings, lists, to-dos (- [ ]), quotes, code, tables, links and **bold**/_italic_.
blocksobject[]Page blocks, including embed blocks. Use instead of markdown.
projectstringWhere a top-level page goes: general, a product key like APP, or a custom project’s id. Defaults to general.
parentIdstring | nullPut it inside this page instead.
folderIdstring | nullFile a top-level page in this folder, in the same project.
iconstringAn icon like hi:rocket, or one emoji.
positionnumberIts place among its siblings.
expectedVersionintegerThe page’s version from your last read.
Response
pageobjectrequiredDetails
Update a page's title, Markdown, blocks or location. folderId files a top-level page; null removes it. Changing parent or project clears its folder unless a matching folderId is sent. expectedVersion prevents overwriting a newer save.