Update Page
confluence_update_pageUpdate existing Confluence pages with new title, content, and settings. Supports multiple content formats and optional minor edits.
Instructions
Update an existing Confluence page.
Args: ctx: The FastMCP context. page_id: The ID of the page to update. title: The new title of the page. content: The new content of the page (format depends on content_format). Mutually exclusive with content_file; exactly one must be supplied. content_file: Filesystem path to read the new page body from (UTF-8). Useful for bodies too large to pass as an inline tool argument. is_minor_edit: Whether this is a minor edit. version_comment: Optional comment for this version. parent_id: Optional new parent page ID. content_format: The format of the content ('markdown', 'wiki', 'storage', or 'xhtml'). enable_heading_anchors: Whether to enable heading anchors (markdown only). include_content: Whether to include page content in the response. emoji: Optional page title emoji (icon shown in navigation). page_width: Optional page layout width ('full-width' or 'default'). table_layout: Optional table width preset ('full-width', 'wide', 'default').
Returns: JSON string representing the updated page object.
Raises: ValueError: If Confluence client is not configured, available, or invalid content_format.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emoji | No | (Optional) Page title emoji (icon shown in navigation). Can be any emoji character like '📝', '🚀', '📚'. Set to null/None to remove. | |
| title | Yes | The new title of the page | |
| content | No | The new content of the page. Format depends on content_format parameter and may be Markdown (default), wiki markup, storage format, or XHTML storage format. Either 'content' or 'content_file' must be provided, but not both. | |
| page_id | Yes | The ID of the page to update | |
| parent_id | No | Optional the new parent page ID | |
| page_width | No | (Optional) Page layout width. Options: 'full-width', 'default'. Defaults to null (preserve existing). | |
| content_file | No | (Optional) Absolute or relative filesystem path to read the new page body from (UTF-8). Use this instead of 'content' when the body is too large to pass comfortably as a tool argument. Mutually exclusive with 'content'. | |
| table_layout | No | (Optional) Table width preset applied to all markdown tables. Options: 'full-width' (1800 px), 'wide' (960 px), 'default' (760 px). Only applies when content_format is 'markdown'. | |
| is_minor_edit | No | Whether this is a minor edit | |
| content_format | No | (Optional) The format of the content parameter. Options: 'markdown' (default), 'wiki', 'storage', or 'xhtml'. Use 'xhtml' when providing Confluence XHTML storage format (same as 'storage'). Wiki format uses Confluence wiki markup syntax | markdown |
| include_content | No | (Optional) Whether to include page content in the response. Defaults to false since callers already have the content at update time | |
| version_comment | No | Optional comment for this version | |
| enable_heading_anchors | No | (Optional) Whether to enable automatic heading anchor generation. Only applies when content_format is 'markdown' |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |