
Atlassian Confluence List
CertifiedList Confluence pages as Markdown
Atlassian Confluence List
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.
type: io.kestra.plugin.confluence.pages.ListExamples
Fetch Confluence pages as Markdown
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
apiToken *Requiredstring
API token for Basic auth
Atlassian API token associated with the username; keep in a secret and avoid logging.
serverUrl *Requiredstring
Set Confluence site URL
Base Confluence site URL (e.g., https://your-domain.atlassian.net) without a trailing slash.
username *Requiredstring
Authentication username (email)
Confluence account email used for Basic authentication; render from secrets where possible.
apiPath string
/wiki/api/v2API 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).
cursor string
Pagination cursor
Opaque cursor returned in the Link response header; pass it to fetch the next page of results.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch 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.
limit integerstring
25Maximum number of results per page
Maximum results per request. Default 25; Min 1; Max 250. Overridden to 1 when fetchType is FETCH_ONE.
pageIds array
Page IDs to filter
Filter results by one or more page IDs (comma-separated). Max items: 250.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
sort string
Sort order of results
Specify sorting of the result set. Valid values: id, -id, created-date, -created-date, modified-date, -modified-date, title, -title.
spaceIds array
Space IDs to filter
Filter results by one or more Confluence space IDs (comma-separated). Max items: 100.
status array
["current","archived"]Page status filter
Filter pages by status. Defaults to current and archived. Valid values: current, archived, deleted, trashed.
subType string
Page subtype filter
Filter by page subtype. Valid values: live (collaborative draft/live page), page (regular page).
title string
Page title filter
Filter results to pages that exactly match this title.
Outputs
children array
Confluence pages
List of fetched pages with title, Markdown body, version info, and raw payload.
io.kestra.plugin.confluence.pages.List-OutputChild
Markdown content
Raw response from Confluence
Full page payload returned by Confluence, including metadata and body.
Page title
Version information
Version map returned by Confluence, including version number and message.
uri string
uriStored results URI
Kestra internal storage URI holding serialized pages when fetchType is STORE.