update_confluence_page

Instructions

Implementation Reference

• src/handlers/page-handlers.ts:235-280 (handler)

  The handler function that executes the update_confluence_page tool logic. It validates inputs (pageId, title, content, version), calls the Confluence client, and returns a simplified response with page id, version, and URL.

  export async function handleUpdateConfluencePage(
    client: ConfluenceClient,
    args: { pageId: string; title: string; content: string; version: number }
  ): Promise<{
    content: Array<{ type: "text"; text: string }>;
  }> {
    try {
      if (!args.pageId || !args.title || !args.content || args.version === undefined) {
        throw new McpError(
          ErrorCode.InvalidParams,
          "pageId, title, content, and version are required"
        );
      }
  
      const page = await client.updateConfluencePage(
        args.pageId,
        args.title,
        args.content,
        args.version
      );
  
      const simplified = {
        id: page.id,
        version: page.version.number,
        url: page._links.webui
      };
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(simplified),
          },
        ],
      };
    } catch (error) {
      console.error("Error updating page:", error instanceof Error ? error.message : String(error));
      if (error instanceof McpError) {
        throw error;
      }
      throw new McpError(
        ErrorCode.InternalError,
        `Failed to update page: ${error instanceof Error ? error.message : String(error)}`
      );
    }
  }

• src/schemas/tool-schemas.ts:113-137 (schema)

  The input schema definition for update_confluence_page. Defines the required parameters: pageId (string), title (string), content (string in storage format), and version (number representing current version).

  update_confluence_page: {
    description: "Update an existing page",
    inputSchema: {
      type: "object",
      properties: {
        pageId: {
          type: "string",
          description: "ID of the page to update",
        },
        title: {
          type: "string",
          description: "New title of the page",
        },
        content: {
          type: "string",
          description: "New content in Confluence storage format",
        },
        version: {
          type: "number",
          description: "Current version number of the page",
        },
      },
      required: ["pageId", "title", "content", "version"],
    },
  },

• src/index.ts:236-247 (registration)

  The tool registration in the MCP server's CallToolRequestSchema handler. Routes the 'update_confluence_page' name to the handler function, extracting the pageId, title, content, and version arguments.

  case "update_confluence_page": {
    const { pageId, title, content, version } = (args || {}) as {
      pageId: string;
      title: string;
      content: string;
      version: number;
    };
    if (!pageId || !title || !content || version === undefined) {
      throw new McpError(ErrorCode.InvalidParams, "pageId, title, content, and version are required");
    }
    return await handleUpdateConfluencePage(this.confluenceClient, { pageId, title, content, version });
  }

• src/client/confluence-client.ts:246-263 (helper)

  The HTTP client helper that performs the actual Confluence API call. Sends a PUT request to /pages/{pageId} with the page title, storage-format body content, and incremented version number.

  async updateConfluencePage(pageId: string, title: string, content: string, version: number): Promise<Page> {
    const body = {
      id: pageId,
      status: 'current',
      title,
      body: {
        representation: 'storage',
        value: content
      },
      version: {
        number: version + 1,
        message: `Updated via MCP at ${new Date().toISOString()}`
      }
    };
  
    const response = await this.v2Client.put(`/pages/${pageId}`, body);
    return response.data;
  }