Update Page Section
confluence_update_page_sectionUpdate a single section of a Confluence page by replacing content under a specific heading, preserving all other sections and elements.
Instructions
Update a single section of a Confluence page without affecting the rest.
Replaces only the content beneath a named heading, leaving all other sections, macros, layouts, and Confluence-specific elements completely intact. This avoids the data loss that occurs when a full page is downloaded as Markdown, edited, and re-uploaded.
Args: ctx: The FastMCP context. page_id: The ID of the page to update. heading_text: Exact heading text identifying the section to replace. new_content: New body content for the section (heading not included). content_format: Format of new_content ('markdown' or 'storage'). is_minor_edit: Whether to flag this as a minor edit. version_comment: Optional version comment.
Returns: JSON string representing the updated page metadata.
Raises: ValueError: If Confluence client is not configured, heading is not found, or content_format is invalid.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page_id | Yes | The ID of the page to update | |
| new_content | Yes | Replacement content for the section body. Do NOT include the heading itself — only the body beneath it. Format is controlled by content_format. | |
| heading_text | Yes | Exact text of the heading that starts the section to replace. Matching is case-sensitive. Use confluence_get_page with convert_to_markdown=false to inspect exact heading text when unsure. | |
| is_minor_edit | No | Whether this is a minor edit | |
| content_format | No | (Optional) Format of new_content. Options: 'markdown' (default) or 'storage' (raw Confluence storage XML). Use 'storage' to insert macros or elements that markdown cannot express. | markdown |
| version_comment | No | Optional comment for this version |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |