Skip to content

manage_pages

Unified tool for Confluence page operations including reading, writing, version history, moving, and diffing.

ParameterTypeRequiredDescription
actionstringYesSee actions below
page_idstringVariesPage ID
space_idstringVariesSpace ID
titlestringVariesPage title
bodystringNoPage body in Confluence storage format (XHTML)
parent_idstringNoParent page ID (for create)
versionintVariesVersion number (for update, move: current + 1)
statusstringNocurrent or draft
body_formatstringNostorage, atlas_doc_format, or view
limitintNoResults per page (default 25)
cursorstringNoPagination cursor
sortstringNoSort order (e.g., -modified-date, title)
target_space_idstringFor moveTarget space ID
target_parent_idstringFor moveTarget parent page ID
from_versionintFor diffStarting version number
to_versionintFor diffEnding version number

Get a page by ID. Returns metadata and body converted to markdown.

Required: page_id

{
"action": "get",
"page_id": "12345678"
}

Get a page by its title within a space.

Required: space_id, title

{
"action": "get_by_title",
"space_id": "131073",
"title": "Architecture Overview"
}

List pages in a space.

Required: space_id

{
"action": "list",
"space_id": "131073",
"sort": "-modified-date",
"limit": 10
}

Get child pages of a page.

Required: page_id

{
"action": "get_children",
"page_id": "12345678"
}

Get ancestor pages (breadcrumb chain) for a page.

Required: page_id

{
"action": "get_ancestors",
"page_id": "12345678"
}

List version history for a page.

Required: page_id

{
"action": "list_versions",
"page_id": "12345678"
}

Response:

[
{
"number": 5,
"message": "Updated architecture",
"author_id": "5b10ac...",
"created": "2025-03-01T09:15:00Z",
"minor_edit": false
}
]

Compare two versions of a page. Returns a unified diff of the markdown content.

Required: page_id, from_version, to_version

{
"action": "diff",
"page_id": "12345678",
"from_version": 3,
"to_version": 5
}

Create a new page.

Required: space_id, title

{
"action": "create",
"space_id": "131073",
"title": "New Page",
"body": "<p>Page content in storage format</p>",
"parent_id": "12345678",
"status": "current"
}

Update an existing page. Version must be current version + 1.

Required: page_id, title, version

{
"action": "update",
"page_id": "12345678",
"title": "Updated Title",
"body": "<p>Updated content</p>",
"version": 6
}

Delete a page.

Required: page_id

{
"action": "delete",
"page_id": "12345678"
}

Move a page to a different space or parent. Version must be current version + 1.

Required: page_id, version, and at least one of target_space_id or target_parent_id

{
"action": "move",
"page_id": "12345678",
"version": 6,
"target_space_id": "196609",
"target_parent_id": "87654321"
}