Confluence

Team wiki. Create, read, and update pages and their children, attach files, comment, label, and search across a whole site.

Measured routing accuracy

42 golden cases replayed through the router over the whole index: measured over corpus ea4f12ad2948 (65 toolkits, 2283 tools indexed and 13 declared uncallable), 30 cases written by hand and 12 cases from the paraphrase pass. A case counts as top-1 when its gold tool ranked first and top-8 when it reached the slate at all.

The sweep is offline: the reranker is a deterministic identity fake that returns candidates in the order retrieval produced them, so top-1 measures retrieval order rather than a reranked slate. just eval-live measures the same cases through the live reranker.

Authentication

Connect an entity with ConnectionsService.InitiateConnection, naming this toolkit's slug. Credentials stay in the connections vault; callers hold connected-account ids only.

oauth2

Tools

30 action tools. The catalog-wide slug is confluence.<tool>, which is what search_tools returns and call_tool takes.

confluence.list_spaces

List or browse the spaces (wikis) on a Confluence site, optionally filtered by key or type. Use when the user asks what spaces exist or wants to find a space's id. For one already-known space use get_space.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/spaces.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what wikis do we have", "show me every team workspace", "which confluence areas exist", "browse the available wikis".

confluence.get_space

Get one Confluence space's (wiki's) detail by id: key, name, type, and its homepage id. Use when the user names a specific space. For the whole list use list_spaces.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/spaces/{{params.space_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "tell me about this workspace", "pull up the engineering wiki area", "what's this team's home base".

confluence.create_space

Create a new Confluence space (wiki) with a unique key and name. Use when the user wants to start, set up, or spin up a new team space, not a page inside one. For a page use create_page instead.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/api/v2/spaces.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "stand up a fresh wiki for the team", "I need somewhere new to keep docs", "open a workspace for this project", "set up a home for our notes".

confluence.update_space

Rename a Confluence space or edit its description. Use when the user wants to edit or update a space's own details, not the pages inside it.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /ex/confluence/{{params.cloud_id}}/wiki/api/v2/spaces/{{params.space_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "rename our team's wiki area", "fix the blurb on our workspace", "change what this wiki is called".

confluence.create_page

Create a new Confluence page in a space, optionally under a parent page. Use when the user wants to write, add, or start a new wiki page or doc. Pass parent_id to make it a child page under an existing one; omit it for a top-level page in the space.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "write up a new doc", "jot down some notes on the wiki", "start a fresh article under this section", "draft something for the team to read".

confluence.get_page

Get one Confluence wiki page's detail and content by id: title, space, parent, current body, and version number. Use when the user asks to read, open, or pull up a specific Confluence page by its id. For a page found only by title use search_pages_by_title first.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "pull up that doc", "show me what's written on this article", "open the wiki entry for this", "read what's on that write-up", "what's on that confluence page".

confluence.update_page

Edit an existing Confluence wiki page's title or content, or move it under a different parent. Use when the user wants to change, edit, rewrite, or retitle a Confluence page. Requires the page's current version number, from get_page, incremented by one.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "fix the wording on this doc", "rewrite this article", "I need to correct what's written here", "refresh the content on this write-up", "edit that confluence page".

confluence.delete_page

Delete a Confluence page. Use when the user wants to delete, remove, or trash a page. By default it moves to the space's trash and can be restored there; pass purge true to permanently delete it right away. Irreversible once purged.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "get rid of this doc for good", "trash that write-up", "throw this article away", "I don't need this page anymore".

confluence.list_pages_in_space

List the pages in one Confluence space, optionally filtered by status. Use when the user asks what pages exist in a space or wants to browse its contents. For a page's child pages specifically, use list_child_pages.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/spaces/{{params.space_id}}/pages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what's written in this workspace", "show me everything under this wiki area", "browse the docs in this team space".

confluence.search_pages_by_title

Find Confluence pages across a site (or one space) by exact title. Use when the user names a page but you only have its title, not its id. For fuzzy keyword or full-text search use search_content instead.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "find the doc called onboarding guide", "I know the name but not where it lives", "look up an article by its exact heading".

confluence.list_child_pages

List the direct child pages nested under a Confluence page. Use when the user asks what sub-pages, nested pages, or children a page has. For every page in the whole space use list_pages_in_space.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/children.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what's nested under this doc", "show me the sub-sections of this article", "what write-ups branch off this one".

confluence.list_attachments

List the files attached to a Confluence page: images, PDFs, spreadsheets, and other uploads. Use when the user asks what's attached to a page or wants to find an attachment by filename.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/attachments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what files are stuck to this doc", "show me the uploads on this article", "what's been dropped onto this write-up".

confluence.get_attachment

Get one Confluence attachment's detail by id: filename, media type, size, and download link. Use when the user names a specific attached file rather than browsing a page's whole attachment list.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/attachments/{{params.attachment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "grab the details on that uploaded file", "where can I download this attached image", "info on the pdf someone put on the page".

confluence.upload_attachment

Attach a new file to a Confluence page. Use when the user wants to add, upload, or attach a file, image, or document to a page. Content is binary data, base64-encoded. To replace an existing attachment's content, use update_attachment_data instead.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/rest/api/content/{{params.page_id}}/child/attachment.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "stick this file onto the doc", "drop an image into the article", "add this pdf to the write-up".

confluence.update_attachment_data

Replace an existing Confluence attachment's binary content, keeping its filename and id. Use when the user wants to overwrite, update, or upload a new version of a file already attached to a page. Content is binary data, base64-encoded.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/rest/api/content/{{params.page_id}}/child/attachment/{{params.attachment_id}}/data.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "swap in a newer version of this file", "replace what's attached with the latest copy", "overwrite that uploaded document".

confluence.delete_attachment

Permanently delete a file attached to a Confluence page. Use when the user wants to delete, remove, or get rid of an attached file, not the whole page. Irreversible.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /ex/confluence/{{params.cloud_id}}/wiki/api/v2/attachments/{{params.attachment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "remove this file from the doc", "get rid of the attached image", "I want that upload gone for good".

confluence.list_footer_comments

List the footer comments on a Confluence page: the discussion thread at the bottom of the page, oldest first. Use when the user wants to read the general discussion on a page. For comments anchored to a specific highlighted bit of text, use list_inline_comments.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/footer-comments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what did people say at the bottom of this doc", "read the general discussion on this article", "show me the thread under this write-up".

confluence.create_footer_comment

Post a footer comment on a Confluence page, or reply to one already there. Use when the user wants to comment, reply, or leave general feedback on a page. For a comment anchored to specific text, use create_inline_comment instead.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/api/v2/footer-comments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "leave a note at the bottom of this doc", "chime in on the discussion for this article", "reply to the thread on this write-up".

confluence.list_inline_comments

List the inline comments on a Confluence page: comments anchored to a specific highlighted selection of text, oldest first. Use when the user wants feedback tied to a particular passage. For the page's general discussion thread, use list_footer_comments.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/inline-comments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what feedback is anchored to that paragraph", "who highlighted and commented on this passage", "show me the annotations on this text".

confluence.create_inline_comment

Post a comment anchored to a specific highlighted selection of text on a Confluence page. Use when the user wants to comment on, flag, or react to one particular passage rather than the page as a whole. For a general comment use create_footer_comment instead.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/api/v2/inline-comments.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "flag this specific sentence with a note", "react to just this highlighted bit", "annotate that particular passage".

confluence.get_comment

Get one Confluence comment's detail by id, footer or inline: its author, text, and version. Use when the user asks about one specific comment rather than a page's whole thread.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/comments/{{params.comment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "pull up what exactly someone wrote there", "show me the details on that one remark", "what did that single reply actually say".

confluence.update_comment

Edit the text of a Confluence comment already posted, footer or inline. Use when the user wants to fix, correct, or update something they or someone else wrote in a comment. Requires the comment's current version number, from get_comment, incremented by one.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /ex/confluence/{{params.cloud_id}}/wiki/api/v2/comments/{{params.comment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "fix a typo in what I wrote earlier", "correct my earlier remark", "edit that note I left".

confluence.delete_comment

Remove a comment from a Confluence page, footer or inline. Use when the user wants to delete or remove a comment, not the whole page. For deleting the page itself use delete_page.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls DELETE /ex/confluence/{{params.cloud_id}}/wiki/api/v2/comments/{{params.comment_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "take down that remark", "erase what I said there", "pull that note off the doc".

confluence.list_page_labels

List the labels (tags) applied to a Confluence page. Use when the user asks what a page is tagged with. To add or remove a label use add_label or remove_label.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/labels.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what tags are on this doc", "how is this article categorized", "show me the topic tags for this write-up".

confluence.add_label

Tag a Confluence page with a label. Use when the user wants to tag, label, or categorize a page. To see what's already applied use list_page_labels; to remove one use remove_label.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/labels.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "tag this doc as a roadmap item", "mark this article under a category", "slap a label on this write-up".

confluence.remove_label

Remove a label from a Confluence page. Use when the user wants to untag, unlabel, or remove a tag from a page, not delete the page itself.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls DELETE /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/labels/{{params.label_id}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "untag this doc", "take that category off the article", "strip the tag from this write-up".

confluence.search_content

Search across an entire Confluence site using CQL (Confluence Query Language), e.g. 'space = "ENG" AND type = page AND text ~ "roadmap"'. Use for any fuzzy, keyword, or cross-space search. For an exact known title use search_pages_by_title instead.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/rest/api/search.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "hunt across the whole wiki for mentions of pricing", "find anything anywhere that talks about the launch", "dig through every space for this keyword".

confluence.list_page_versions

List a Confluence page's version history, newest first: who changed it, when, and their edit message. Use when the user asks about a page's history, past edits, or revisions. For one specific past version's content use get_page_version.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/versions.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "show me the edit history of this doc", "who changed this article and when", "what past revisions exist for this write-up".

confluence.get_page_version

Get one specific past version of a Confluence page by version number: who made that edit, when, and their message. Use when the user asks about an older revision by number rather than the current content (use get_page for that).

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/api/v2/pages/{{params.page_id}}/versions/{{params.version_number}}.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "what did this doc look like three edits ago", "pull up an older revision by number", "show me a specific past copy of this article".

confluence.get_current_user

Get the profile of the connected Confluence account itself: accountId, display name, and email. Use to answer "who am I" on Confluence, as opposed to Jira's separate get_current_user.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /ex/confluence/{{params.cloud_id}}/wiki/rest/api/user/current.

Arguments:

Result fields (the payload is trimmed to these before it reaches the model):

Also retrieved by: "who am I signed in as here", "what's my confluence identity", "show my own profile on this site".