Confluence Pages

Confluence Pages

Certified

Tasks that create, list, and update Confluence pages with Markdown rendering and metadata controls.

Use these tasks to publish or sync documentation while keeping Confluence as the source of truth; they convert Markdown to the storage format and return results as JSON, Markdown, or stored files. Each call needs Confluence credentials (serverUrl, username, apiToken); create/update expect page details and Markdown content (update also requires pageId, status, title, and versionInfo), and list supports filters for spaces, page IDs, titles, status, subtype, sorting, and pagination.

How to use the Confluence plugin

Create, list, and update Confluence pages from Kestra flows using Markdown content.

Authentication

Set serverUrl (e.g. https://your-domain.atlassian.net), username (your Atlassian account email), and apiToken (your Atlassian API token) on each task. For self-hosted Confluence, override apiPath — it defaults to /wiki/api/v2 for Cloud. Store credentials in secrets and apply them globally with plugin defaults.

Tasks

pages.Create creates a new page — set spaceId, title, and markdown for the page body. Use parentId to nest it under an existing page, and status to create as current (published) or draft.

pages.List retrieves pages as Markdown. Filter by spaceIds, pageIds, or title. Control output with fetchType: FETCH returns all results as a list, FETCH_ONE returns the first match, and STORE writes results to internal storage for large result sets.

pages.Update modifies an existing page — set pageId, title, markdown, status, and versionInfo (a map with number and message describing the new version).