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
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 IDtitle: Page titleexcerpt: Page excerpt with highlightsurl: Page URLspace: Space informationversion: Page version detailslastModified: 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
Authenticate using OAuth
Test the connection with a simple read operation
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
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]

