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.

​

Available Actions

​

Search

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. Use when user asks for recent, latest, or sorted results.
  • limit (NUMBER, Optional): Number of results to return (1-250). Use when user specifies how many pages they want or for pagination. Default is 25.
  • cursor (TEXT, Optional): Pagination cursor for getting next set of results. Use when user wants to continue browsing or get more results after initial query.
  • title (TEXT, Optional): Filter by exact page title only (no partial matching). Use when user provides the complete, exact page title.
  • pageIds (TEXT, Optional): Get specific pages by their IDs. Use when user provides specific page IDs or when you have IDs from previous queries.

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 (e.g., when a user requests pages from a space but only provides the space name). Requires Confirmation: No Parameters:

• ids (TEXT, Optional): Filter results to spaces with these IDs. Use when user provides specific space IDs.
  • keys (TEXT, Optional): Filter results to spaces with these keys. Use when user provides specific space keys or short names.
  • type (TEXT, Optional): Filter by space type (global, collaboration, knowledge_base, personal). Use when user specifies a type of space.
  • status (TEXT, Optional): Filter by space status (current, archived). Use when user specifies only active or archived spaces.
  • labels (TEXT, Optional): Filter by space labels. Use when user specifies labels or tags for spaces.
  • favoritedBy (TEXT, Optional): Filter to spaces favorited by a specific user (by account ID). Use when user asks for their favorite spaces.
  • 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. Use when user provides a page title or heading.
  • bodyContent (MULTI_LINE_TEXT, Optional): Content of the page in Confluence storage format or HTML. Use when user provides page content, text, or wants to add information to the page.
  • status (TEXT, Optional): Page status: ‘current’ for published pages, ‘draft’ for draft pages. Use ‘draft’ when user wants to save without publishing. Default is ‘current’.
  • parentId (TEXT, Optional): ID of parent page to create this page under. Use when user wants to create a sub-page or organize content hierarchically. Leave empty for space homepage.
  • subtype (TEXT, Optional): Page subtype. Use ‘live’ to create a live document that supports real-time collaboration. Leave empty for regular pages.
  • private (BOOLEAN, Optional): Set to true to create a private page that only the creator can view and edit. Use when user wants to create personal or private content.
  • rootLevel (BOOLEAN, Optional): Set to true to create the page at space root level (outside space homepage tree). Use when user wants a top-level page not under the homepage.
  • embedded (BOOLEAN, Optional): Set to true to create embedded content. Use for special content types that will be embedded elsewhere.

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 users only want to change 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. Required. Can be found using search or get_pages actions.
  • title (TEXT, Required): New title for the page. Required. Use when user wants to change the page title or heading.
  • titleChangeOnly (BOOLEAN, Optional): Set to true when only changing the page title (efficient, no version number needed). Set to false when updating content. Use true for rename operations to save tokens.
  • bodyContent (MULTI_LINE_TEXT, Optional): New content for the page in Confluence storage format or HTML. Required when titleChangeOnly=false. Not needed when titleChangeOnly=true.
  • versionNumber (NUMBER, Required): Current version number of the page. REQUIRED by Confluence API when titleChangeOnly=false (for optimistic locking to prevent edit conflicts). The version will be automatically incremented for the update. If not provided, it will be fetched automatically. Not needed when titleChangeOnly=true.
  • status (TEXT, Optional): Page status: ‘current’ for published, ‘draft’ for draft. Use when user wants to publish/unpublish or change page status. Default is ‘current’.
  • versionMessage (TEXT, Optional): Optional message describing the changes made in this update. Use when user provides context about their changes. Only used when titleChangeOnly=false.
  • parentId (TEXT, Optional): ID of new parent page to move this page under within the same space. Use when user wants to reorganize page hierarchy. Only used when titleChangeOnly=false.
  • ownerId (TEXT, Optional): Account ID of new page owner to transfer ownership. Use when user wants to change who owns the page. Only used when titleChangeOnly=false.
  • spaceId (TEXT, Optional): ID of containing space. Note: Moving pages to different spaces is not currently supported by the API. Only used when titleChangeOnly=false.

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

​

Best Practices

​

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 support@langdock.com