[mintlify]

Documents that the admin MCP create_node tool now writes into an existing page when a page already exists at the given path, instead of failing.

The page keeps its place in the navigation and the response includes updated: true, so an AI tool can safely rerun an interrupted run. A new page whose content fails to save now returns PAGE_SEED_FAILED instead of reporting success, and retrying with the same path writes the content.

Based on create_node upserts existing pages, a merged admin MCP change.

Duplicate check: searched open and recent docs PRs by rgodha24 and ethanpalm, mintlify[bot] PRs, and titles containing "MCP" and "create_node". Open PR #7963 edits the edit_page and write_page bullets on the same page; this PR only touches the create_node bullet.

---

Note

Low Risk
Documentation-only change describing admin MCP behavior; no runtime or security impact in this repo.

Overview
Updates the admin MCP create_node docs to match new upsert behavior for pages.

When a page already exists at the given path on branch, create_node now writes the new content into that page instead of erroring. The page stays in its current nav position (even if a different parent is passed), and the response includes updated: true so agents can safely retry interrupted runs.

The bullet also documents PAGE_SEED_FAILED when navigation is created but page content cannot be saved, and that calling create_node again with the same path is the recovery path to write the content.

^{Reviewed by Cursor Bugbot for commit 0211cdd. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
Mintlify Docs	🟢 Ready	View Preview	Oct 22, 2026, 6:18 PM