Confluence

Overview

Collaborative workspace that connects teams with the content they need. Through Langdock’s integration, you can access and manage Confluence directly from your conversations.

Authentication: OAuth Category: Productivity & Collaboration Availability: All workspace plans

Available Actions

confluence.search

Searches for pages by content and title matching using text queries. Use this for partial title matches, keyword searches, or content searches. Requires Confirmation: No

Parameters:

  • query (TEXT, Optional): Text to search for in page titles and content. Searches both titles (with wildcard matching for partial matches) and full page content. Use for any user search request including keywords, phrases, or partial titles. Leave empty to get recent pages.

Output: Returns an array of search results with page information including:

  • id: Page ID

  • title: Page title

  • excerpt: Page excerpt with highlights

  • url: Page URL

  • space: Space information

  • version: Page version details

  • lastModified: Last modified date


Search (Native)

confluence.searchNative

Searches for pages and content within your Confluence workspace. Requires Confirmation: No

Parameters:

  • query (TEXT, Optional): A query string for filtering the file results. If no query string is passed, it returns the most recent pages. This searches through the full text and the titles of the pages

Output: Returns search results optimized for file search functionality


Download File

confluence.downloadFile

Downloads a specific file from your Confluence workspace. Requires Confirmation: No

Parameters:

  • itemId (TEXT, Required): The unique identifier of the file you want to download from Confluence

Output: Returns the file content as binary data


Get Pages

confluence.getPages

Gets pages using structured filters like space, status, or sorting. Use this when users want to list/browse pages from specific spaces, get recent pages, or filter by criteria (e.g., ‘get all pages from Marketing space’, ‘show me recent pages’, ‘list draft pages’). Requires Confirmation: No

Parameters:

  • spaceId (TEXT, Optional): Filter pages by specific space ID. If the user requests pages from a space and only provides the space name, first call the get_spaces action to look up the space and retrieve its ID by name or key, then use that ID here.

  • status (TEXT, Optional): Filter by page status. Use ‘current’ for published pages, ‘draft’ for draft pages. Default is ‘current’ if not specified.

  • sort (TEXT, Optional): Sort order for results. Use ‘created-date’ for newest first, ‘modified-date’ for recently updated, ‘title’ for alphabetical.

  • limit (NUMBER, Optional): Number of results to return (1-250). Default is 25.

  • cursor (TEXT, Optional): Pagination cursor for getting next set of results.

  • title (TEXT, Optional): Filter by exact page title only (no partial matching).

  • pageIds (TEXT, Optional): Get specific pages by their IDs.

Output: Returns an array of pages with their details including title, content, space, and metadata


Get Folder

confluence.getFolder

Retrieves a specific Confluence folder by its ID. Use this action when users ask for pages of a folder. Requires Confirmation: No

Parameters:

  • folderId (TEXT, Required): The unique id of the folder you want to retrieve the contents of, can be found by using the search confluence action

Output: Returns folder contents and metadata


Get Spaces

confluence.getSpaces

Lists all spaces in the Confluence workspace. Use this action when the user asks for available spaces, or when you need to look up a space ID by name or key before calling other actions. Requires Confirmation: No

Parameters:

  • ids (TEXT, Optional): Filter results to spaces with these IDs.

  • keys (TEXT, Optional): Filter results to spaces with these keys.

  • type (TEXT, Optional): Filter by space type (global, collaboration, knowledge_base, personal).

  • status (TEXT, Optional): Filter by space status (current, archived).

  • labels (TEXT, Optional): Filter by space labels.

  • favoritedBy (TEXT, Optional): Filter to spaces favorited by a specific user (by account ID).

  • notFavoritedBy (TEXT, Optional): Filter to spaces NOT favorited by a specific user (by account ID).

  • sort (TEXT, Optional): Sort the result by a particular field (id, key, name, etc).

  • descriptionFormat (TEXT, Optional): Format for the space description field (plain, view).

  • includeIcon (BOOLEAN, Optional): Set to true to include the space icon in the response.

  • cursor (TEXT, Optional): Pagination cursor for getting next set of results.

  • limit (NUMBER, Optional): Maximum number of spaces to return (1-250).

Output: Returns an array of spaces with their details including name, key, description, and metadata


Create Page

confluence.createPage

Creates a new page in a Confluence space. Use this when users want to create new content, add a page, or publish information to Confluence. Requires Confirmation: Yes

Parameters:

  • spaceId (TEXT, Required): ID of the space where the page will be created. Required. Use get_spaces action to find space ID if only space name is provided.

  • title (TEXT, Optional): Title of the page. Required for published pages, optional for drafts.

  • bodyContent (MULTI_LINE_TEXT, Optional): Content of the page in Confluence storage format or HTML.

  • status (TEXT, Optional): Page status: ‘current’ for published pages, ‘draft’ for draft pages. Default is ‘current’.

  • parentId (TEXT, Optional): ID of parent page to create this page under.

  • subtype (TEXT, Optional): Page subtype. Use ‘live’ to create a live document that supports real-time collaboration.

  • private (BOOLEAN, Optional): Set to true to create a private page that only the creator can view and edit.

  • rootLevel (BOOLEAN, Optional): Set to true to create the page at space root level.

  • embedded (BOOLEAN, Optional): Set to true to create embedded content.

Output: Returns the created page with its ID and metadata


Update Page

confluence.updatePage

Updates an existing Confluence page by ID. Can update title only (efficient) or full content. Use titleChangeOnly=true when only changing the page title/heading for token efficiency. Use titleChangeOnly=false for content changes. Requires Confirmation: Yes

Parameters:

  • pageId (TEXT, Required): ID of the page to update.

  • title (TEXT, Required): New title for the page.

  • titleChangeOnly (BOOLEAN, Optional): Set to true when only changing the page title (efficient). Set to false when updating content.

  • bodyContent (MULTI_LINE_TEXT, Optional): New content for the page in Confluence storage format or HTML. Required when titleChangeOnly=false.

  • versionNumber (NUMBER, Required): Current version number of the page. REQUIRED by Confluence API when titleChangeOnly=false.

  • status (TEXT, Optional): Page status: ‘current’ for published, ‘draft’ for draft.

  • versionMessage (TEXT, Optional): Optional message describing the changes made in this update.

  • parentId (TEXT, Optional): ID of new parent page to move this page under within the same space.

  • ownerId (TEXT, Optional): Account ID of new page owner to transfer ownership.

  • spaceId (TEXT, Optional): ID of containing space. Note: Moving pages to different spaces is not currently supported by the API.

Output: Returns the updated page with its ID and metadata


Get Page

confluence.getPage

Retrieves a specific Confluence page by its ID including its content and metadata. Requires Confirmation: No

Parameters:

  • pageId (TEXT, Required): The unique id of the page you want to retrieve the content of, can be found by using the search confluence action

Output: Returns the page content and metadata

Triggers

New Page

confluence.newPage Triggers when new pages are published in Confluence. Requires Confirmation: No Parameters: None Output: Returns information about newly published pages


Updated Page

confluence.updatedPage Triggers when a published Confluence page is updated. Requires Confirmation: No

Parameters:

  • pageId (TEXT, Required): The id of the page that should be monitored for updates

Output: Returns information about updated pages

Common Use Cases

  • Data Management — Manage and organize your Confluence data

  • Automation — Automate workflows with Confluence

  • Reporting — Generate insights and reports

  • Integration — Connect Confluence with other tools

Best Practices

1

Getting Started

Enable the Confluence integration in your workspace settings

2

Authenticate using OAuth

3

Test the connection with a simple read operation

4

Explore available actions for your use case

Important Considerations:

  • Ensure proper authentication credentials

  • Respect rate limits and API quotas

  • Review data privacy settings

  • Test operations in a safe environment first

Troubleshooting

Issue
Solution

Authentication failed

Verify your OAuth credentials

Rate limit exceeded

Reduce request frequency

Data not found

Check permissions and data availability

Connection timeout

Verify network connectivity

Support

For additional help with the Confluence integration, contact [email protected]envelope