---
name: docs/confluence-official:page-update
description: Update an existing Confluence page
version: "0.5.0"
---

> **Backend:** confluence-official (atlassian@claude-plugins-official)
> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

# Page Update

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| page_id | string | Yes | Confluence page ID to update |
| title | string | Yes | Page title (no colons) |
| body | string | Yes | Page content in Confluence storage format |
| version | integer | Yes | Current page version number; auto-incremented by the API |

## Implementation

Uses MCP Confluence tool: `mcp__atlassian__updateConfluencePage`

Version is automatically incremented from the current version. Retrieve the current version number first with `confluence-official:page-read`.

## Output

| Field | Type | Description |
|-------|------|-------------|
| id | string | Page ID |
| title | string | Updated page title |
| version | number | New version number after update |
| url | string | URL to the updated page |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| NOT_FOUND | Page ID does not exist | Verify page_id with `confluence-official:page-read` |
| VERSION_CONFLICT | Provided version does not match current version | Re-read the page to get the latest version number |
| INVALID_TITLE | Title contains a colon or other disallowed character | Replace `:` with `-` in the title |
| PERMISSION_DENIED | Token lacks write access to the page | Check plugin configuration and Confluence token scopes |
| PLUGIN_UNAVAILABLE | atlassian@claude-plugins-official plugin is not installed or not responding | Run `/plugin install atlassian@claude-plugins-official` and retry |

## Used By

- design-solution (updating specification pages with revised content)
- sync-context (writing synced content back to existing pages)
