@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

next
md 44 lines 2.64 KB
Rendered Raw
1 ---
2 type: "reference"
3 title: "Confluence"
4 description: "Public support knowledge for Confluence."
5 category: "auth-config"
6 visibility: "public"
7 timestamp: "2026-07-16T00:00:00Z"
8 tags:
9 - "confluence"
10 ---
11 # Confluence
12
13
14 ## Confluence custom OAuth should keep scopes aligned with Composio defaults and endpoint type
15
16 For Confluence custom OAuth, keep Atlassian scopes aligned with the scopes Composio expects. Classic and granular scopes differ depending on whether the underlying Confluence endpoint is v1 or v2. Incorrect substitutions such as using an irrelevant space scope can cause tool execution errors even if OAuth completes.
17
18 ## Add `offline_access` to Confluence auth configs when refresh tokens are needed
19
20 For Confluence OAuth, include the `offline_access` scope in the auth config and then create a new connected account. `offline_access` enables token refresh, and adding it to an existing auth config only affects new connections after users reconnect.
21
22 ## Use connected account ID, not auth config ID, when executing Confluence tools
23
24 For Confluence tool execution, pass the connected account ID. Do not pass the auth config ID/integration ID in the connected account field. Older SDK versions may also require the UUID form rather than the nano ID, so verify the SDK version and expected ID format.
25
26 ## Use `CONFLUENCE_GET_PAGE_BY_ID` to retrieve Confluence page content
27
28 Use `CONFLUENCE_GET_PAGE_BY_ID` to retrieve Confluence page content by page ID. This is the tool support shared for page body retrieval.
29
30 ## `CONFLUENCE_UPDATE_PAGE` should be paired with `CONFLUENCE_GET_PAGE_VERSIONS` for versioned updates
31
32 Confluence page updates require the correct page version. Pair `CONFLUENCE_UPDATE_PAGE` with `CONFLUENCE_GET_PAGE_VERSIONS` so the agent can fetch the latest required version and then update the page. By default, the agent should update over the latest version unless a specific version is requested.
33
34 ## Download Confluence attachments by first getting attachment IDs
35
36 Use `CONFLUENCE_GET_ATTACHMENTS` to list attachments and get the attachment ID, then pass that ID to `CONFLUENCE_DOWNLOAD_ATTACHMENT` to download the file.
37
38 ## Confluence tool scopes are exposed in MCP listTools annotations for supported deployments
39
40 For supported MCP deployments, Confluence scopes can be retrieved from the `annotations` field in the `listTools` API response.
41
42 ## For Atlassian/Confluence OAuth, use the same redirect URI in auth config and Atlassian app
43
44 The redirect URI in the Composio auth config and the Atlassian OAuth app must match. Copy the callback shown by the current auth-config flow or documentation; do not reuse legacy v1 or v3 callback paths from old support answers.