Confluence Node

The Confluence node provides integration with Atlassian Confluence in SkyStudio workflows. You can read Confluence pages, spaces, and blog posts, and run AI-powered natural language queries.

🎬 Click to watch the video →

Connection Setup and Management

To use the Confluence node, you must first create an Atlassian connection.

Adding a New Connection

Go to Application Connections from the left menu in SkyStudio.
Click the Add New Connection button.
Fill in the following information:

Field	Description	Example
Connection Name	The name you want to give this connection	`Company Confluence`
Provider	Connection type	`Confluence`
Confluence Cloud Domain	Subdomain of your Atlassian account	`mycompany.atlassian.net`
Email	Email registered to your Atlassian account	`user@company.com`
API Token	Atlassian API token	`ATATT3xFfGF0...`

Creating an API Token

Go to id.atlassian.com/manage-profile/security/api-tokens.
Click the Create API token button.
Give the token a label, such as SkyStudio, and create it.
Copy the generated token and paste it into the API Token field in SkyStudio.

Note: The API token can only be viewed once. Make sure you copy it immediately.

Assigning the Connection to the Node

After dragging the Confluence node onto the canvas, select the connection you created from the Application Connections dropdown in the right panel.

When manual mode is selected, you can enter the connection information directly into the fields.

Operations

The Confluence node provides 7 operations:

Operation	Category	Description
List Spaces	Featured	Lists all spaces in Confluence
Confluence AI Assistant	Featured	Queries Confluence data using natural language
List Pages	Standard	Lists pages in a specific space
Get Page Content	Standard	Retrieves the content of a single page by ID
Get Child Pages	Standard	Retrieves the child pages of a page
Get Page History	Standard	Retrieves the revision history of a page
Get Blog Pages	Standard	Retrieves blog posts in a specific space

List Spaces

Returns all spaces in your Confluence account. It is used to discover which spaces you can access and to find Space Key values.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Space Type	No	Space type filter, such as global or personal
Get All (Auto Paginate)	No	Retrieves all results automatically with pagination
Limit	No	Maximum number of records to retrieve

Example Output

{
  "results": [
    {
      "id": "123456",
      "key": "TECH",
      "name": "Technical Documentation",
      "type": "global",
      "status": "current"
    }
  ]
}

Confluence AI Assistant

Allows you to query Confluence data using natural language. It is ideal for accessing information without writing complex Confluence queries.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Query	Yes	Search question written in natural language
System Prompt	No	System instruction that customizes the AI assistant’s behavior

Usage Example

Query: "Find pages related to the onboarding process"

System Prompt: "Consider only pages updated in the last 6 months"

Tip: You can use the System Prompt to define constraints for the AI assistant, such as a specific space, author, or time range.

List Pages

Returns the list of pages in a specific Confluence space.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Space Key	No	Space key from which pages will be listed, such as `TECH`
Expand Fields	No	Additional fields to expand in the response
Get All (Auto Paginate)	No	Retrieves all results automatically with pagination
Limit	No	Maximum number of pages to retrieve
File Path	No	File path where the result will be saved

Example Output

{
  "results": [
    {
      "id": "98765",
      "title": "API Integration Guide",
      "space": {
        "key": "TECH"
      },
      "version": {
        "number": 5
      },
      "_links": {
        "webui": "/spaces/TECH/pages/98765"
      }
    }
  ]
}

Get Page Content

Retrieves the full content of a Confluence page by Page ID.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Page ID	Yes	Confluence ID of the page whose content will be retrieved
Body Format	No	Content format, such as `storage`, `view`, or `export_view`
File Path	No	File path where the result will be saved

How to Find the Page ID

Open the page in Confluence. The numeric value after /pages/ in the URL is the Page ID.

Example:

https://mycompany.atlassian.net/wiki/spaces/TECH/pages/98765

Page ID:

Body Format Options

storage — Confluence’s internal XML format, used as the default
view — HTML view format
export_view — HTML optimized for export

Get Child Pages

Retrieves the direct child pages or all hierarchical child pages of a parent page. It is useful for mapping page trees.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Page ID	Yes	ID of the parent page whose child pages will be listed
Recursive (All Children)	No	If enabled, retrieves child pages across the entire hierarchy
Limit	No	Maximum number of child pages to retrieve
File Path	No	File path where the result will be saved

About Recursive Mode

When Recursive (All Children) is disabled, only direct child pages one level below are returned.

When it is enabled, the entire hierarchy, including descendants, is retrieved.

Get Page History

Returns the full revision history of a Confluence page. It is suitable for audit and tracking scenarios with information about who changed what and when.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Page ID	Yes	Confluence ID of the page whose history will be retrieved
File Path	No	File path where the result will be saved

Example Output

{
  "results": [
    {
      "number": 7,
      "when": "2024-11-15T10:23:00.000Z",
      "by": {
        "displayName": "Ahmet Yılmaz"
      },
      "message": "Installation steps updated"
    }
  ]
}

Get Blog Pages

Lists blog posts in a specific Confluence space.

Parameters

Parameter	Required	Description
Connection	Yes	The Confluence connection to use
Space Key	No	Space key from which blog posts will be retrieved, such as `TEAM`
Limit	No	Maximum number of blog posts to retrieve
File Path	No	File path where the result will be saved

Quick Start Examples

Example 1: Technical Documentation Search Assistant

A workflow that finds answers from Confluence for questions asked by the user in natural language:

Text Input → Confluence AI Assistant → Text Output

Confluence AI Assistant settings:

Query: {{input.text}}
System Prompt: "Look only at pages in the TECH space. Respond in Turkish."

Example 2: Weekly Documentation Report

A workflow that lists pages updated every week and sends a report to the team:

Schedule → List Pages → LLM (summarize) → Slack Message

List Pages settings:

Space Key: TECH
Get All (Auto Paginate): Enabled
Limit: 50

Example 3: Extracting Page Hierarchy

A workflow that lists all pages under the main documentation page:

Text Input (Page ID) → Get Child Pages → JSON to Table → Table Output

Get Child Pages settings:

Page ID: {{input.text}}
Recursive (All Children): Enabled

Common Errors

Error	Possible Cause	Solution
`401 Unauthorized`	Invalid API token or email	Check the connection settings and renew the token
`403 Forbidden`	No permission to access the page	Check user permissions in Atlassian
`404 Not Found`	Invalid Page ID or Space Key	Verify the ID or Key values from the Confluence URL
`429 Too Many Requests`	API request limit exceeded	Add delay between requests or reduce the limit value
`Space not found`	Incorrect Space Key	Check the space list using List Spaces

Notes

The File Path parameter is used to save results directly to a file in operations that return large amounts of data. You can process this file later in the workflow.
The Get All (Auto Paginate) option may slow down spaces with many records. It is recommended to use it together with Limit.
Confluence Cloud and Confluence Server APIs are different. This node is designed for Confluence Cloud, also known as Atlassian Cloud.

Connection Setup and Management​

Adding a New Connection​

Creating an API Token​

Assigning the Connection to the Node​

Operations

List Spaces

Parameters​

Example Output​

Confluence AI Assistant

Parameters​

Usage Example​

List Pages

Parameters​

Example Output​

Get Page Content

Parameters​

How to Find the Page ID​

Body Format Options​

Get Child Pages

Parameters​

About Recursive Mode​

Get Page History

Parameters​

Example Output​

Get Blog Pages

Parameters​

Quick Start Examples

Example 1: Technical Documentation Search Assistant​

Example 2: Weekly Documentation Report​

Example 3: Extracting Page Hierarchy​

Common Errors

Notes

Connection Setup and Management

Adding a New Connection

Creating an API Token

Assigning the Connection to the Node

Parameters

Example Output

Parameters

Usage Example

Parameters

Example Output

Parameters

How to Find the Page ID

Body Format Options

Parameters

About Recursive Mode

Parameters

Example Output

Parameters

Example 1: Technical Documentation Search Assistant

Example 2: Weekly Documentation Report

Example 3: Extracting Page Hierarchy