Atlassian Confluence List

Atlassian Confluence List

Certified

List Confluence pages as Markdown

Retrieves pages via REST API v2, converts storage HTML to Markdown, and supports filtering by space, page, status, subtype, or title. Default limit is 25 with statuses current and archived; FETCH_ONE forces limit 1, and STORE writes results to internal storage.

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

Fetch Confluence pages as Markdown

yaml
id: fetch-confluence-pages
namespace: company.team

tasks:
  - id: list_pages
    type: io.kestra.plugin.confluence.pages.List
    serverUrl: https://your-domain.atlassian.net
    username: user@example.com
    apiToken: "{{ secret('CONFLUENCE_API_TOKEN') }}"
Properties

API token for Basic auth

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

Set Confluence site URL

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

Authentication username (email)

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

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).

Pagination cursor

Opaque cursor returned in the Link response header; pass it to fetch the next page of results.

DefaultFETCH
Possible Values
STOREFETCHFETCH_ONENONE

Fetch type

Determines how results are returned. FETCH returns a list, FETCH_ONE limits to the first page, STORE writes all pages to internal storage and returns a URI. Default: FETCH.

Default25

Maximum number of results per page

Maximum results per request. Default 25; Min 1; Max 250. Overridden to 1 when fetchType is FETCH_ONE.

SubTypeinteger

Page IDs to filter

Filter results by one or more page IDs (comma-separated). Max items: 250.

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

Sort order of results

Specify sorting of the result set. Valid values: id, -id, created-date, -created-date, modified-date, -modified-date, title, -title.

SubTypeinteger

Space IDs to filter

Filter results by one or more Confluence space IDs (comma-separated). Max items: 100.

SubTypestring
Default["current","archived"]

Page status filter

Filter pages by status. Defaults to current and archived. Valid values: current, archived, deleted, trashed.

Page subtype filter

Filter by page subtype. Valid values: live (collaborative draft/live page), page (regular page).

Page title filter

Filter results to pages that exactly match this title.

Confluence pages

List of fetched pages with title, Markdown body, version info, and raw payload.

Definitions
markdownstring

Markdown content

rawResponseobject

Raw response from Confluence

Full page payload returned by Confluence, including metadata and body.

titlestring

Page title

versionInfoobject

Version information

Version map returned by Confluence, including version number and message.

Formaturi

Stored results URI

Kestra internal storage URI holding serialized pages when fetchType is STORE.