--- title: Confluence API Integration on Truto slug: confluence category: Knowledge Management canonical: "https://truto.one/integrations/detail/confluence/" --- # Confluence API Integration on Truto **Category:** Knowledge Management **Status:** Generally available ## Unified APIs ### Unified Knowledge Base API - **Files** — - **Page-Content** — Represents the content of a page - **Pages** — Represents the pages, posts, articles in a knowledge base - **Permissions** — Permissions can answer your questions around which User has access to do what. - **Spaces** — Represents the high level grouping of pages in a knowledge base - **Tags** — Represents the tags in a knowledge base - **Users** — The User object represents a User. ### Unified User Directory API - **Activities** — Activities are the actions performed by users in the source application. - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Me** — - **Users** — The User object represents a User. ### Unified Search API - **Search** — Search endpoint for all the apps. ## MCP-ready AI tools Truto exposes 18 tools for Confluence that AI agents can call directly. - **list_all_confluence_users** — Search users using the CQL query in Confluence. Returns user details including accountId, username, displayName, email, profilePicture, and personalSpace. Note some fields may be null due to privacy settings. - **get_single_confluence_user_by_id** — Use this endpoint to get a single user in the Zoho Bigin account. It always requires the ID to fetch. - **list_all_confluence_accessible_resources** — Get list of accessible resources in Confluence. Returns id, name, url, scopes, and avatarUrl for each resource. - **list_all_confluence_groups** — Get all user groups in Confluence. Returns groups ordered alphabetically by name with fields id, name, and type. - **get_single_confluence_group_by_id** — Get group information by id in Confluence. Returns type, name, id, and _links fields of the group. - **confluence_groups_remove_member** — Remove user as a member from a group in Confluence using groupId and accountId. Returns no content on success. - **list_all_confluence_audit_logs** — Get audit records filtered by startDate and endDate in Confluence. Returns fields including author, remoteAddress, creationDate, summary, description, category, sysAdmin, superAdmin, affectedObject, changedValues, and associatedObjects. - **list_all_confluence_pages** — Get all pages in Confluence filtered by id, space_id, status, or title. Returns fields including id, status, title, spaceId, parentId, version details, and body content in specified format. - **get_single_confluence_page_by_id** — Get a specific page by id in Confluence. Returns fields including id, status, title, spaceId, parentId, version details, body content, labels, properties, operations, likes, versions, and isFavoritedByCurrentUser. - **create_a_confluence_page** — Create a page in Confluence with required spaceId and title if status is current. Returns id, status, title, spaceId, parentId, authorId, createdAt, version details, body content, labels, properties, operations, likes, versions, and favorite status. - **update_a_confluence_page_by_id** — Update a page by id in Confluence. Requires id, status, title, body, and version number. Returns updated page fields including id, status, title, spaceId, parentId, version details, body content, labels, properties, operations, likes, versions, and links. Note: Changing status from 'current' to 'draft' deletes existing draft; restoring 'trashed' pages changes status only. - **list_all_confluence_spaces** — Retrieves a list of spaces from your Confluence account. A space is a collection of related pages, blogs, and other content that helps teams organize work. You can filter the results by space ids, keys, type (e.g., global, personal), status (e.g., current, archived), labels, favorited-by, and not-favorited-by query parmeters. You can also control the response format for space description by using the description-format query parameter. Use the include-icon query parameter to include a space icon in the response. The response consists of each space’s key, name, type, status, description, the ID of the author who created the space, creation timestamp, and description. - **get_single_confluence_space_by_id** — Get space by id in Confluence. Returns fields id, key, name, type, status, authorId, createdAt, homepageId, description, icon, labels, properties, operations, permissions, and _links. - **list_all_confluence_search** — Get search results for content using the cql query in Confluence. Returns results array with content id, type, title, space, version, body views, and excerpt fields. Note user-specific CQL fields are deprecated. - **list_all_confluence_user_groups** — Get group memberships for user with accountId in Confluence. Returns groups with fields type, name, and id. - **list_all_confluence_me** — Use this endpoint to get the information about the currently authenticated user in the Zoho Bigin account. - **list_all_confluence_attachments** — Get attachments for page with id in Confluence. Returns fields id, status, title, createdAt, mediaType, fileSize, webuiLink, downloadLink, and version details. Results limited by limit parameter. - **list_all_confluence_labels** — Get all labels in Confluence. Returns label id, name, and prefix fields. Use limit to control number of labels returned. ## How it works 1. **Link your customer's Confluence account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Confluence.** The Proxy API is a 1-to-1 mapping of the Confluence API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Power AI search and support bots with Confluence knowledge** — SaaS companies building AI-powered support or search products can ingest their customers' Confluence pages, attachments, and labels to populate vector databases — giving their AI agents accurate, up-to-date context from the customer's internal wiki without any manual export. - **Auto-publish generated documentation into Confluence** — Meeting intelligence tools, CI/CD platforms, or project management SaaS can programmatically create and update Confluence pages — pushing meeting summaries, release notes, or status reports directly into the right Space so distributed teams stay informed without copy-pasting. - **Surface Confluence content inside your product via federated search** — Developer portals, incident management tools, or enterprise search products can query Confluence using CQL through Truto's Unified Search API, letting users find runbooks, post-mortems, and documentation without leaving the SaaS tool they're already working in. - **Sync user and group data for access-aware features** — SaaS products that need to understand organizational structure or enforce permission-aware content delivery can pull Confluence users, groups, and group memberships via Truto's Unified User Directory API — ensuring the right people see the right content. - **Build automated account handoff and onboarding workflows** — CRM and revenue platforms can generate structured Confluence pages on deal close or project kickoff, automatically creating account briefs, onboarding checklists, or project wikis in the customer's Confluence workspace without manual intervention. ## What you can build - **One-click Confluence knowledge sync for RAG pipelines** — Let your users connect their Confluence account, select target Spaces, and automatically sync all pages, child pages, and attachments into your AI's knowledge base with ongoing incremental updates. - **Automated meeting notes publisher** — After each meeting, generate a structured Confluence page with transcript summary, action items, and attendee list in a user-designated Space — no manual documentation needed. - **In-app Confluence search with CQL** — Embed a search bar in your product that queries Confluence via CQL, filtering by space, labels, or content type, and returns relevant pages and snippets directly in your UI. - **Space and page browser for content selection** — Build a configuration UI where end users browse their Confluence Spaces and Pages to select exactly which content your product should index, sync, or act on. - **Bi-directional page updates with version management** — Push status changes, enriched metadata, or generated content back to existing Confluence pages using proper version incrementing, keeping documentation in sync with your product's state. - **Group-based content access controls** — Pull Confluence groups and memberships to enforce permission-aware content delivery in your product, ensuring users only see knowledge base content their Confluence access allows. ## FAQs ### What authentication method does the Confluence integration use? Truto handles OAuth 2.0 authentication for Confluence Cloud via Atlassian's identity platform. Your end users go through a standard OAuth consent flow to connect their Confluence account. Truto manages token refresh and storage so you never deal with auth plumbing directly. ### How does Truto handle Confluence's page versioning when updating pages? When you update a Confluence page via Truto's update_a_confluence_page_by_id, you need to pass the current version number incremented by 1. Truto's unified API abstracts much of this, but understanding Confluence's strict version requirement is important — attempting to update without the correct version will fail. ### Can I search Confluence content using CQL through Truto? Yes. The list_all_confluence_search tool supports Confluence Query Language (CQL), allowing you to filter by space, labels, content type, and more. This maps to Truto's Unified Search API, so you can build powerful federated search experiences. ### What Confluence content formats are returned when fetching pages? Confluence returns page body content in its storage format (a specific XHTML-based markup). When you fetch pages via get_single_confluence_page_by_id or list_all_confluence_pages, you'll receive this storage format content along with metadata like title, space, author, and version info. ### Does Truto handle pagination for large Confluence instances? Yes. Truto automatically manages cursor-based and offset pagination across all Confluence endpoints. Whether you're listing thousands of pages, users, or search results, Truto handles the pagination logic so you receive complete result sets through a consistent interface. ### Which Unified APIs does the Confluence integration support? Confluence maps to three Truto Unified APIs: the Unified Knowledge Base API (covering Spaces, Pages, Page-Content, Files/Attachments, Tags/Labels, Permissions, and Users), the Unified User Directory API (covering Users, Groups, Me, and Activities), and the Unified Search API. This means you can swap or add other knowledge management tools with minimal code changes.