Skip to main content

Add comment

Action ID: tools.confluence.add_page_comment Add a comment to a Confluence page. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content/{id}/child-commentsOfContent

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

content
string
required
Comment content in Confluence storage (XHTML) or wiki markup. Convert Markdown to storage before sending if needed.
page_id
string
required
The ID of the page to comment on.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
content_representation
string
Content representation for the comment body (storage or wiki).Default: "storage".

Add page label

Action ID: tools.confluence.add_page_label Add a label to a Confluence page. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#label-addLabelsToContent

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

name
string
required
Label name to apply.
page_id
string
required
The ID of the page to label.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
prefix
string
Label prefix (global, my, or team).Default: "global".

Create page

Action ID: tools.confluence.create_page Create a new Confluence page in a space, optionally under a parent. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-createContent

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

content
string
required
Page body in Confluence storage (XHTML) or wiki markup. Convert Markdown to storage before sending if needed.
space_key
string
required
Space key for the page (e.g., DEV, TEAM).
title
string
required
Title of the new page.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
content_representation
string
Content representation for the body (storage or wiki).Default: "storage".
parent_id
string | null
Optional parent page ID to nest under.Default: null.

Delete page

Action ID: tools.confluence.delete_page Delete a Confluence page by ID. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-delete

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

page_id
string
required
The ID of the page to delete.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.

Get child pages

Action ID: tools.confluence.get_page_children List child pages for a parent Confluence page with pagination and optional content expansion. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content/{id}/child-childrenOfType

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

parent_id
string
required
The ID of the parent page whose children you want to retrieve.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
expand
string
Fields to expand on each child (e.g., version, body.storage, body.view).Default: "version".
include_content
boolean
Whether to force body.storage expansion for child content.Default: false.
limit
integer
Maximum number of child pages to return (1-50).Default: 25.
start
integer
Starting index for pagination (0-based).Default: 0.

Get page by ID

Action ID: tools.confluence.get_page Retrieve a Confluence page by its numeric ID with optional expanded fields. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-getContentById

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

page_id
string
required
Confluence page ID (numeric). In URLs like https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title the ID is 123456789.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
expand
string
Comma-separated fields to expand (e.g., body.storage, body.view, version, space, ancestors, children.attachment).Default: "body.storage,version,space".

Get page by title

Action ID: tools.confluence.get_page_by_title Find a Confluence page by title within a space. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-getContent

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

space_key
string
required
Space key containing the page (e.g., DEV, TEAM).
title
string
required
Exact page title to retrieve.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
expand
string
Comma-separated fields to expand (e.g., body.storage, body.view, version, space, ancestors, children.attachment).Default: "body.storage,version,space".

Get page comments

Action ID: tools.confluence.get_page_comments Retrieve comments for a Confluence page with pagination support. Use start/limit to iterate through all comments. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content/{id}/child-commentsOfContent

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

page_id
string
required
Confluence page ID to fetch comments for.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
depth
string
Depth of comments to return (e.g., all, root).Default: "all".
expand
string
Fields to expand on each comment (e.g., body.view, body.storage, version).Default: "body.view,version".
limit
integer
Maximum number of comments to return per request (1-50).Default: 25.
start
integer
Starting index for pagination (0-based). Use _links.next from response to get next page.Default: 0.

Get page labels

Action ID: tools.confluence.get_page_labels List labels applied to a Confluence page. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#label-getLabelsForContent

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

page_id
string
required
The ID of the page to fetch labels for.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.

Search content

Action ID: tools.confluence.search_content Search Confluence content with Confluence Query Language (CQL) and optional space filters. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#search-search

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

query
string
required
Search query in CQL. Examples: ‘type=page AND space=DEV’, ‘title~“Runbook”’, or ‘text ~ “incident response”’. CQL supports operators like AND/OR, ranges, and exact matches.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
limit
integer
Maximum number of results to return (1-50).Default: 10.
spaces_filter
string | null
Optional comma-separated space keys to filter results (adds OR space clauses to the query).Default: null.

Update page

Action ID: tools.confluence.update_page Update an existing Confluence page, incrementing the version automatically. Reference: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-update

Secrets

Required secrets:
  • confluence: required values CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN.

Input fields

content
string
required
Updated page body in Confluence storage (XHTML) or wiki markup. Convert Markdown to storage before sending if needed.
page_id
string
required
ID of the page to update.
title
string
required
New title for the page.
base_url
string | null
Confluence site base URL (e.g., https://example.atlassian.net/wiki). Do not append /rest/api.Default: null.
content_representation
string
Content representation for the body (storage or wiki).Default: "storage".
is_minor_edit
boolean
Whether this is a minor edit for versioning purposes.Default: false.
parent_id
string | null
Optional new parent page ID to set on update.Default: null.
version_comment
string
Optional version comment to record with the update.Default: "".