Pages

patch_page

Literal find/replace edits on a draft page (auto-opens from published). find is not regex; 0 matches -> E_PATCH_NO_MATCH, N matches without occurrence -> E_PATCH_AMBIGUOUS (no write). occurrence: "first" or "all". if_revision:null pins to the revision read. Caps: 1..20 edits, find <=2000 B, replace <=5000 B, total <=20000 B. Not for new pages or publishing.

Behaviour

Effect
Destructive. It can remove or overwrite existing data.
Repeat calls
Idempotent. Repeating the same call produces the same result.
Plan
Available on every plan, including free.

Parameters

NameTypeRequiredDescription
request_idstringYesUnique mutation ID. Reuse only to replay identical arguments; use a new ID for changed arguments or after E_CONFLICT.
site_iduuidYesSite UUID from list_sites or create_site.
pathstringYesPage URL path, e.g. '/pricing'. Leading slash required.
if_revisionstring or nullYesCurrent selected revision from get_site, list_pages or get_page. Use null only when source is none. Refresh after E_CONFLICT.
expected_page_typeenum
html | jsx | markdown | svg | mermaid
NoOptional guard: if set, the current page's type must match, otherwise the tool returns E_CONFLICT and no write occurs.
editsarray of objectYesOrdered list of literal find/replace edits to apply sequentially. 1..20 items. Combined find + replace bytes across all edits must be <= 20000. Atomic: if any edit fails validation, no write occurs.

Returns

NameTypeDescription
pageobject
contentobject
idempotency_replayboolean

Using it

patch_page is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 38 Sentway tools. See connecting over MCP.