Atlassian Confluence Update

Atlassian Confluence Update

Certified

Update Confluence page content

Updates an existing page by ID through REST API v2. Renders Markdown to Confluence storage HTML, bumps the page version using versionInfo, and supports title/status/parent/owner updates within the same space.

yaml
type: io.kestra.plugin.confluence.pages.Update

Update the title and content of a specific Confluence page.

yaml
id: update-confluence-page
namespace: company.team

tasks:
  - id: update_page
    type: io.kestra.plugin.confluence.pages.Update
    serverUrl: https://your-domain.atlassian.net
    username: user@example.com
    apiToken: "{{ secret('CONFLUENCE_API_TOKEN') }}"
    pageId: "12345678"
    status: current
    title: New Page Title
    markdown: |
      # My Updated Content\nThis is the new content for the page.
    versionInfo:
      number: 2
      message: Updated content and title via Kestra.
Properties

API token for Basic auth

Atlassian API token associated with the username; keep in a secret and avoid logging.

Markdown content to upload

Markdown rendered to Confluence storage HTML before sending to the API.

Page ID

Confluence page identifier to update; used in the request path.

Set Confluence site URL

Base Confluence site URL (e.g., https://your-domain.atlassian.net) without a trailing slash.

Page status

Required page status. Valid values: current, draft. Changing from current to draft deletes any existing draft.

Page title

Updated page title.

Authentication username (email)

Confluence account email used for Basic authentication; render from secrets where possible.

Version information

Required version payload. Must include number (integer) and message (non-blank comment) for the new version.

Default/wiki/api/v2

API base path

Base path appended to the server URL before the resource endpoint. Defaults to /wiki/api/v2 for Confluence Cloud. Override for On-Premise instances (e.g., /rest/api or a custom context root).

Owner Account ID

Account ID of the page owner; transfers ownership to another user.

Parent page ID

Parent content ID for re-parenting within the same space.

Reference (ref) of the pluginDefaults to apply to this task.

Space ID

ID of the containing space; must stay within the current space because cross-space moves are not supported.

Update page output

Raw JSON response returned by Confluence after the update.