Move a Page to a New Parent

Move a Page to a New Parent

Works with AI assistants

Reparent a Confluence page under a different page in the tree.

1. Read the page being moved to capture its title, space, status, and the current version number that the update must supersede.
2. Read the intended parent to confirm it exists and to compare its space against the source page's space; Confluence will not accept a move that crosses spaces via parentId alone.
3. List the pages already sitting under the target parent so a duplicate title at the destination is visible before the move is committed.
4. Commit the move by updating the page with the new parentId, preserving its existing title, space, and status.

What you'll need to have ready

• pageId: The id of the page to move.
• newParentId: The id of the page that should become the new parent.
• newVersionNumber: The version number to write, which Confluence requires to be the current version plus one. Arazzo runtime expressions have no arithmetic, so the caller supplies
• versionMessage: Optional changelog message recorded on the new version.

For your developer

Arazzo workflow confluence:move-page-to-new-parent, 4 operations: getPageById → getPageById → getChildPages → updatePage. Specs on APIs.io.