For the complete documentation index, see llms.txt. This page is also available as Markdown.

Confluence

Your Toolhouse AI Worker can connect to Confluence using 62 specialized tools.

Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.

Tools (62)

Confluence Add Content Label

Integration name: CONFLUENCE_ADD_CONTENT_LABEL

Tool to add labels to a piece of content. Use after obtaining the content ID to tag pages or blog posts with metadata labels.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678-90ab-cdef-1234-567890abcdef"

Identifier of the Confluence content (page or blog post) to label.

labels

array

List of labels to add to the content. Each element must be an object with prefix (one of global, team, or my) and name (lowercase alphanumeric/hyphenated string) fields — e.g., {'prefix': 'global', 'name': 'my-label'}. Passing plain strings or omitting prefix causes schema validation errors.


Integration name: CONFLUENCE_CQL_SEARCH

Searches for content in Confluence using Confluence Query Language (CQL). CQL is a powerful query language that allows you to search across all Confluence content with advanced filtering capabilities including:

  • Full-text search: text ~ "search term" - searches within page content

  • Title search: title ~ "meeting notes" - searches page titles

  • Label filtering: label = "important" - filters by labels

  • Space filtering: space = DEV - limits search to specific spaces

  • Type filtering: type = page or type = blogpost - filters by content type

  • Creator filtering: creator = currentUser() - filters by content creator

  • Date filtering: lastModified > now("-7d") - filters by modification date

  • Combined queries: text ~ "api" AND space = DOCS AND type = page

This action uses the Confluence REST API v1 search endpoint which fully supports CQL.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

cql

string

"text ~ \"API documentation\""

Confluence Query Language (CQL) query for searching content. CQL allows searching by content text, title, labels, creator, type, space, and more. Examples: text ~ "search term" (full-text search), label = "important" (search by label), type = page AND space = DEV (pages in DEV space), creator = currentUser() (content by current user), title ~ "meeting notes" AND lastModified > now("-7d") (recent pages with title matching). Supported fields: text, title, label, space, type, creator, contributor, created, lastModified, ancestor, content, id. Supported operators: = (equals), != (not equals), ~ (contains), !~ (does not contain), > < >= <= (comparisons), IN, NOT IN. Keywords: AND, OR, NOT, ORDER BY.

limit

integer

25

Maximum number of results to return (max 250, but may be limited to 25-50 when using body expansions)

start

integer

0

Starting index for pagination (0-based)

expand

string

"content.space"

Comma-separated list of properties to expand in the response. Common values: content.space, content.version, content.body.storage, content.body.view. Note: Using body expansions may limit results to 25-50.

excerpt

string

"highlight"

The type of excerpt to return. Default is highlight.

includeArchivedSpaces

boolean

Whether to include results from archived spaces


Confluence Create Blogpost

Integration name: CONFLUENCE_CREATE_BLOGPOST

Tool to create a new Confluence blog post. Use when you need to publish content in a specific space. Response includes data.id for the post ID and data._links.base + data._links.webui for the URL.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

body

object

Content body of the blog post. Must be a dict with representation set to 'storage' and value containing valid Confluence storage format markup (XML-based). Raw markdown or plain strings will cause validation errors.

title

string

"Quarterly Update"

The title of the new blog post.

status

string

"current"

Status of the blog post. Use 'current' to publish immediately (publicly visible) or 'draft' to save as private draft.

spaceId

string

"65701"

ID of the space where the blog post will be created.


Confluence Create Blogpost Property

Integration name: CONFLUENCE_CREATE_BLOGPOST_PROPERTY

Tool to create a property on a specified blog post. Use when you need to add custom metadata to a blog post. Creates a new property with a key-value pair on a specified Confluence blog post. This allows users to add custom metadata relevant to the blog post.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Identifier of the Confluence blog post to add the property to.

key

string

"customMeta"

Unique key for the blog post property.

value

string

"{\"exampleKey\": \"exampleValue\"}"

JSON string representing the value of the blog post property.


Confluence Create Content Property For Whiteboard

Integration name: CONFLUENCE_CREATE_CONTENT_PROPERTY_FOR_WHITEBOARD

Tool to create a new content property on a whiteboard. Use when you need to attach custom metadata to a Confluence whiteboard.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"status"

Key/name of the property to create.

value

string

"{\"type\": \"urgent\", \"deadline\": \"2024-01-30\"}"

JSON string representing the value of the content property.

whiteboard_id

string

"abc123-whiteboard-id"

ID of the whiteboard to add the property to.


Integration name: CONFLUENCE_CREATE_FOOTER_COMMENT

Tool to create a footer comment on a Confluence page, blog post, attachment, or custom content. Use when you need to add a comment without editing the page body itself.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

body

object

The body content of the comment with representation format and value.

pageId

string

"12345678"

ID of the page to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId.

blogPostId

string

"87654321"

ID of the blog post to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId.

attachmentId

string

"att-123456"

ID of the attachment to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId.

customContentId

string

"custom-123"

ID of the custom content to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId.

parentCommentId

string

"comment-12345"

ID of the parent comment. Provide this to create a reply to an existing comment.


Confluence Create Page

Integration name: CONFLUENCE_CREATE_PAGE

Tool to create a new Confluence page in a specified space. Use when you need to create new documentation or content.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

body

object

Wrapper for page body content.

title

string

"Meeting Notes"

Title of the new page. Title uniqueness is scoped per parent: duplicates are allowed under different parents but not under the same parent.

spaceId

string

"12345678"

ID or key of the space where the page will be created. Can be a numeric space ID (e.g., '12345678') or a space key (e.g., 'DOCS', 'TEAM'). Space keys are automatically converted to IDs.

parentId

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the parent page. If omitted, the Confluence API will automatically place the page under the space's homepage. Provide this to create the page as a child of a specific page. Must be a numeric page ID only — page titles and page keys are not accepted and will cause errors. Obtain numeric IDs via list or search APIs.


Confluence Create Page Property

Integration name: CONFLUENCE_CREATE_PAGE_PROPERTY

Tool to create a property on a Confluence page. Use when you need to add custom metadata or settings to a page.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"status"

Key/name of the property to create.

value

string

"{\"type\": \"urgent\", \"deadline\": \"2024-01-30\"}"

Value of the property as a JSON string. Can represent any JSON type (string, number, object, array).

page_id

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the page to create a property for.


Confluence Create Private Space

Integration name: CONFLUENCE_CREATE_PRIVATE_SPACE

Tool to create a private Confluence space. Use when you need an isolated workspace viewable only by its creator.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"PERS1"

A unique key for the private space; must be unique and <=255 characters. Must be alphanumeric only (no hyphens, underscores, or spaces).

name

string

"My Private Space"

The name of the private space, visible only to its creator.

description

object

Container for the plain-text description.


Confluence Create Space

Integration name: CONFLUENCE_CREATE_SPACE

Tool to create a new Confluence space. Use when setting up a new knowledge area for organization. Must include a plain.representation field, e.g., {"plain": {"representation": "plain", "value": "text here"}}. Omitting this field causes a 400 error.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"DOCS"

A unique key for the space. Must be alphanumeric characters only (letters and numbers), up to 255 characters. Underscores and hyphens are not allowed.

name

string

"Documentation"

Human-readable name for the space.

type

string

"global"

Type of the space, either global or personal.

metadata

string

Optional metadata for the space as a JSON string.

description

object

Description object for a Confluence space.


Confluence Create Space Property

Integration name: CONFLUENCE_CREATE_SPACE_PROPERTY

Tool to create a new property on a Confluence space. Use after confirming the space ID when adding custom metadata.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

key

string

"property-key"

Unique key for the space property.

value

string

"{\"example\": \"value\"}"

JSON string representing the value of the space property.

spaceId

string

"SPACE123"

ID of the space to add the property to.

version

object

Optional version metadata for the new property.


Confluence Create Whiteboard

Integration name: CONFLUENCE_CREATE_WHITEBOARD

Tool to create a new Confluence whiteboard. Use when you need to start a collaborative whiteboard session.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

title

string

"Team Brainstorm"

Title of the whiteboard.

spaceId

string

"12345678"

ID of the space where the whiteboard will be created.

parentId

string

"1234abcd-1234-5678-abcd-1234567890ab"

ID of the parent content under which the whiteboard will be created.


Confluence Delete Blogpost Property

Integration name: CONFLUENCE_DELETE_BLOGPOST_PROPERTY

Tool to delete a blog post property. Use when you need to remove custom metadata from a specified blog post.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

ID of the Confluence blog post containing the property.

propertyId

8093697

The ID of the blog post property to delete. Can be a numeric ID or a property key string.


Confluence Delete Content Property For Page By Id

Integration name: CONFLUENCE_DELETE_CONTENT_PROPERTY_FOR_PAGE_BY_ID

Tool to delete a content property from a page by property ID. Use when you need to remove custom metadata from a page for cleanup or auditing. This action deletes a specified content property from a Confluence page using its page ID and property ID. It is useful for removing outdated or unnecessary metadata.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

pageId

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the Confluence page from which to delete the property.

propertyId

8093697

The ID of the content property to delete from the page. Can be a numeric ID or a property key string.


Confluence Delete Content Property For Whiteboard By Id

Integration name: CONFLUENCE_DELETE_CONTENT_PROPERTY_FOR_WHITEBOARD_BY_ID

Tool to delete a content property from a whiteboard by property ID. Use when you need to remove custom metadata from a whiteboard.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

propertyId

8093697

The ID of the property to delete from the whiteboard. Can be a numeric ID or a property key string.

whiteboardId

string

"abc123-whiteboard-id"

ID of the whiteboard from which to delete the property.


Confluence Delete Page

Integration name: CONFLUENCE_DELETE_PAGE

Tool to delete a Confluence page. Use with caution as this permanently removes the page and its content with no recovery option. In move or migration workflows, confirm all target pages were successfully created before deleting source pages — partial creation failures combined with deletion result in unrecoverable data loss.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the page to delete.


Confluence Delete Space

Integration name: CONFLUENCE_DELETE_SPACE

Tool to delete a Confluence space by its key. Use when you need to permanently remove a space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

space_key

string

"DEV"

Key of the space to delete.


Confluence Delete Space Property

Integration name: CONFLUENCE_DELETE_SPACE_PROPERTY

Tool to delete a space property. Use when you need to remove a property from a Confluence space after review.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

propertyId

8093697

The ID of the space property to delete. Can be a numeric ID or a property key string.

spaceIdOrKey

integer

163984

The numeric Long ID of the space containing the property. Must be a numeric space ID, not a space key or UUID.


Confluence Download Attachment

Integration name: CONFLUENCE_DOWNLOAD_ATTACHMENT

Downloads an attachment from a Confluence page and returns a publicly accessible S3 URL. Use this when you need to share the attachment with users who don't have Confluence access. First use get_attachments to list attachments and get the attachment ID.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

pageId

string

"65816"

ID of the Confluence page that contains the attachment.

attachmentId

string

"att65825"

ID of the attachment to download (e.g., 'att65825').


Confluence Get Attachment Labels

Integration name: CONFLUENCE_GET_ATTACHMENT_LABELS

Tool to list labels on an attachment. Use after confirming the attachment ID to fetch its labels.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"att64913409"

Identifier of the Confluence attachment to retrieve labels for.

sort

string

"name"

Sort the result by a particular field.

limit

integer

25

Maximum number of labels to return per page (1-250).

cursor

string

"eyJpZCI6IjEyMzQ1Njc4IiwiY29udGVudE9yZGVyIjoiaWQifQ=="

Opaque cursor for pagination. Returned in the Link response header for fetching the next page.

prefix

string

"global"

Filter labels by their prefix.


Confluence Get Attachments

Integration name: CONFLUENCE_GET_ATTACHMENTS

Tool to retrieve attachments of a Confluence page. Use after confirming page ID to list its attachments (supports pagination).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of attachments to return per page. Confluence caps at 200.

start

integer

0

Zero-based index of the first item to return (pagination offset).

pageId

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the Confluence page whose attachments will be retrieved.

mediaType

string

"image/jpeg"

Filter attachments by MIME type (e.g., 'image/png', 'application/pdf').


Confluence Get Audit Logs

Integration name: CONFLUENCE_GET_AUDIT_LOGS

Tool to retrieve Confluence audit records. Use when you need to fetch and filter audit logs for compliance or troubleshooting.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of audit records to return per page.

start

integer

0

Zero-based index of the first audit record to return (pagination offset).

endDate

integer

1704153599000

End of the audit record timestamp range (epoch time in milliseconds).

startDate

integer

1672531200000

Start of the audit record timestamp range (epoch time in milliseconds).

searchString

string

"user login"

Free-text search to filter audit records by summary or category.


Confluence Get Blogpost By Id

Integration name: CONFLUENCE_GET_BLOGPOST_BY_ID

Tool to retrieve a specific Confluence blog post by its ID. Use when you have a blog post ID and need detailed metadata and content.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Unique identifier of the Confluence blog post to retrieve.


Confluence Get Blogpost Labels

Integration name: CONFLUENCE_GET_BLOGPOST_LABELS

Tool to retrieve labels of a specific Confluence blog post by ID. Use after obtaining the blog post ID to list its labels.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Identifier of the Confluence blog post to retrieve labels for.

limit

integer

25

Maximum number of labels to return per page.

start

integer

0

Zero-based index of the first label to return (pagination offset).


Confluence Get Blogpost Like Count

Integration name: CONFLUENCE_GET_BLOGPOST_LIKE_COUNT

Tool to get like count for a Confluence blog post. Use after confirming the blog post ID to retrieve total likes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Identifier of the Confluence blog post to retrieve like count for.


Confluence Get Blogpost Operations

Integration name: CONFLUENCE_GET_BLOGPOST_OPERATIONS

Tool to retrieve permitted operations for a Confluence blog post. Use after confirming the blog post ID to see allowed actions.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Identifier of the Confluence blog post to query operations for.


Confluence Get Blog Posts

Integration name: CONFLUENCE_GET_BLOG_POSTS

Tool to retrieve a list of blog posts. Use when you need a paginated list of Confluence blog posts.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of items to return per page.

cursor

string

"eyJvZmZzZXQiOjI1fQ=="

Opaque pagination cursor for fetching the next page of results.


Confluence Get Blog Posts For Label

Integration name: CONFLUENCE_GET_BLOG_POSTS_FOR_LABEL

Tool to list all blog posts under a specific label. Use when you have a label ID and need to retrieve associated blog posts.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the label to retrieve blog posts for.

limit

integer

25

Maximum number of items to return per page.

cursor

string

"eyJvZmZzZXQiOjI1fQ=="

Opaque pagination cursor for fetching the next page of results.


Confluence Get Blogpost Version Details

Integration name: CONFLUENCE_GET_BLOGPOST_VERSION_DETAILS

Tool to retrieve details for a specific version of a blog post. Use when you have a blogpostId and versionNumber and need detailed metadata for that version.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

blogpostId

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Unique identifier of the Confluence blog post.

versionNumber

integer

1

Version number of the blog post to retrieve.


Confluence Get Blogpost Versions

Integration name: CONFLUENCE_GET_BLOGPOST_VERSIONS

Tool to retrieve all versions of a specific blog post. Use when you have a blogpostId and need to list version numbers.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of version items to return per page.

cursor

string

"eyJvZmZzZXQiOjI1fQ=="

Cursor for pagination. Use value from previous response to fetch next page.

blogpostId

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

The unique identifier of the Confluence blog post.


Confluence Get Child Pages

Integration name: CONFLUENCE_GET_CHILD_PAGES

Tool to list all direct child pages of a given Confluence page. Use when you have a parent page ID and need to discover its direct descendants. Response nests child page data under data.data.results; unwrap this before iterating. Paginate using _links.next cursor until no further results to avoid missing children.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the Confluence page to retrieve child pages for. Returned child page IDs may be non-numeric strings; do not assume integer format when storing or passing to subsequent calls.

sort

string

Sort order options for child pages.

limit

integer

25

Maximum number of items to return per page. Maximum cap is 100. Paginate until _links.next is absent to ensure all children are retrieved.

cursor

string

Cursor for pagination. Use the cursor from the previous response's _links.next to get the next page of results.


Confluence Get Content Properties For Blog Post

Integration name: CONFLUENCE_GET_CONTENT_PROPERTIES_FOR_BLOG_POST

Tool to retrieve all content properties on a blog post. Use when you need to list metadata properties set on a specific Confluence blog post.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of properties to return per page.

start

integer

0

Zero-based index of the first property to return (pagination offset).

blogpost_id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Identifier of the Confluence blog post to retrieve properties for.


Confluence Get Content Properties For Page

Integration name: CONFLUENCE_GET_CONTENT_PROPERTIES_FOR_PAGE

Tool to retrieve all content properties on a page. Use when you need to list metadata properties set on a specific Confluence page.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of properties to return per page (max 200).

cursor

string

"eyJvZmZzZXQiOjI1fQ=="

Opaque pagination cursor for fetching the next page of results.

page_id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

Identifier of the Confluence page to retrieve properties for.


Confluence Get Content Restrictions

Integration name: CONFLUENCE_GET_CONTENT_RESTRICTIONS

Tool to retrieve restrictions on a Confluence content item. Use when you need to see who can view or edit a page or blog post.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"123e4567-e89b-12d3-a456-426614174000"

ID of the content to retrieve restrictions for.

expand

array

["user","operation"]

Comma-separated properties to expand in the response, e.g., ['restrictables.operation', 'user']


Confluence Get Current User

Integration name: CONFLUENCE_GET_CURRENT_USER

Tool to get information about the currently authenticated user — always scoped to the account tied to the configured connection, not arbitrary users. Use CONFLUENCE_SEARCH_USERS to look up other users. Response contains nested metadata; key fields include accountId, displayName, and email for use in downstream logic.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Confluence Get Inline Comments For Blog Post

Integration name: CONFLUENCE_GET_INLINE_COMMENTS_FOR_BLOG_POST

Tool to retrieve inline comments for a Confluence blog post. Use when you need inline comment details by blog post ID.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"10158081"

Unique identifier of the blog post to retrieve inline comments for.

sort

string

"created-date"

Sort order for results. Use - prefix for descending order.

limit

integer

25

Maximum number of inline comments to return per page (default 25, max 250).

cursor

string

"eyJpZCI6IjEyMzQ1NiJ9"

Cursor for pagination. Use the cursor from _links.next in the previous response to get the next page.

body_format

string

"storage"

The content format type for the comment body. Valid values: storage, atlas_doc_format.


Confluence Get Labels

Integration name: CONFLUENCE_GET_LABELS

Tool to retrieve all labels in a Confluence site; use for label discovery when you need to list or page through labels. For label-based filtering, use CONFLUENCE_GET_LABELS_FOR_PAGE or CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT instead.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of labels to return per page.

start

integer

0

Zero-based index of the first label to return (pagination offset).


Confluence Get Labels For Page

Integration name: CONFLUENCE_GET_LABELS_FOR_PAGE

Tool to retrieve labels of a specific Confluence page by ID. Labels are returned in data.results[*].name and are not available in CONFLUENCE_GET_PAGES responses. Use after obtaining the page ID to list its labels. Paginate using start and limit to avoid missing labels when count exceeds 25.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678-90ab-cdef-1234-567890abcdef"

Identifier of the Confluence page to retrieve labels for.

limit

integer

25

Maximum number of labels to return per page.

start

integer

0

Zero-based index of the first label to return (pagination offset). Increment by limit value iteratively to paginate through all labels; omitting pagination will miss labels beyond the first 25.


Confluence Get Labels For Space

Integration name: CONFLUENCE_GET_LABELS_FOR_SPACE

Tool to list labels on a space. Use when you need to retrieve labels for a specific space.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

"123456"

ID of the space to retrieve labels for (numeric space ID).

sort

string

"name"

Sort order for results. Use - prefix for descending order.

limit

integer

25

Maximum number of labels to return per page (default 25, max 250).

cursor

string

"eyJpZCI6MTIzfQ=="

Cursor for pagination. Use the cursor from the previous response to get the next page.

prefix

string

"global"

Filter labels by prefix.


Confluence Get Labels For Space Content

Integration name: CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT

Tool to list labels on all content in a space. Use when you need to retrieve or filter content labels by space, with pagination and optional prefix filtering. For label discovery across a space before per-page filtering, use this tool first, then CONFLUENCE_GET_LABELS_FOR_PAGE; CONFLUENCE_SEARCH_CONTENT does not filter by labels.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

The ID of the space to list content labels for.

limit

integer

25

Maximum number of labels to return per page.

start

integer

0

Zero-based index of the first label to return (pagination offset).

prefix

string

"global"

Filter labels by this prefix (e.g., 'global', 'page-').


Confluence Get Page Ancestors

Integration name: CONFLUENCE_GET_PAGE_ANCESTORS

Tool to retrieve all ancestors for a given Confluence page by its ID. Use when you need the full page hierarchy.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the Confluence page to retrieve ancestors for.


Confluence Get Page By Id

Integration name: CONFLUENCE_GET_PAGE_BY_ID

Tool to retrieve a Confluence page by its ID. Use when you have a page ID and need its detailed metadata and content. Response body is in body.storage.value as Confluence storage format (HTML); strip tags before plain-text use. Before calling CONFLUENCE_UPDATE_PAGE, fetch the latest version here — that tool requires version.number = current + 1, else a 409 conflict occurs.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678"

Numeric Long ID of the Confluence page to retrieve. Must be a numeric long value, not a UUID or string identifier. Accepts both id and page_id parameter names for compatibility.

draft

boolean

true

Whether to return the draft version (default: false).

version

integer

1

Specific page version to retrieve (default: latest).


Integration name: CONFLUENCE_GET_PAGE_FOOTER_COMMENTS

Tool to retrieve footer (non-inline) comments for a Confluence page. Use when you need to collect review feedback left as standard page comments.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"10158081"

Unique identifier of the page to retrieve footer comments for.

sort

string

"created-date"

Sort order for results. Use - prefix for descending order.

limit

integer

50

Maximum number of footer comments to return per page (default 50, max 250).

cursor

string

"eyJpZCI6IjEyMzQ1NiJ9"

Cursor for pagination. Use the cursor from _links.next in the previous response to get the next page.

status

array

["current"]

Filter comments by status. Can include multiple statuses.

body_format

string

"storage"

The content format type for the comment body. Valid values: storage, atlas_doc_format.


Confluence Get Page Inline Comments

Integration name: CONFLUENCE_GET_PAGE_INLINE_COMMENTS

Tool to retrieve inline comments for a Confluence page. Use when you need inline comment details by page ID.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

integer

10158081

Numeric ID of the page to retrieve inline comments for.

sort

string

"created-date"

Sort order for results. Use - prefix for descending order.

limit

integer

25

Maximum number of inline comments to return per page (default 25, max 250).

cursor

string

"eyJpZCI6IjEyMzQ1NiJ9"

Cursor for pagination. Use the cursor from _links.next in the previous response to get the next page.

status

array

["current"]

Filter comments by status. Pass an array of status values.

body_format

string

"storage"

The content format type for the comment body. Valid values: storage, atlas_doc_format.

resolution_status

array

["open"]

Filter comments by resolution status. Pass an array of resolution status values (e.g., 'open', 'resolved').


Confluence Get Page Like Count

Integration name: CONFLUENCE_GET_PAGE_LIKE_COUNT

Tool to get like count for a Confluence page. Use after confirming the page ID to retrieve total likes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"1234abcd-56ef-78gh-90ij-123456klmnop"

Identifier of the Confluence page to retrieve like count for.


Confluence Get Pages

Integration name: CONFLUENCE_GET_PAGES

Tool to retrieve a paginated list of Confluence pages. Results are permission-scoped to the authenticated user; empty results may reflect access restrictions. Omitting filters like spaceId or status can return unexpectedly broad result sets. Labels are not included in results; use CONFLUENCE_GET_LABELS_FOR_PAGE for label data. Timestamps are ISO 8601 UTC strings.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

sort

string

"created-date"

Sort order for Confluence pages using AbstractPageSortOrder enum values.

limit

integer

25

Maximum number of pages to return per page. Confluence caps at 250.

title

string

Filter by page title (exact match).

cursor

string

Opaque pagination cursor. Use the 'next' link from a previous response to continue. Iterate until no 'next' link is returned to avoid silently missing pages.

status

["current"]

Filter by page status. Allowed values: current, archived, deleted, trashed.

subtype

string

Filter by page subtype. Valid values: live, page.

space_id

163984

Filter by space ID(s). Provide a single ID or a list of IDs.

body_format

string

Body representation to include in results. Allowed values: 'storage' (storage format) or 'atlas_doc_format' (Atlas document format). The value 'view' is not supported.


Confluence Get Page Versions

Integration name: CONFLUENCE_GET_PAGE_VERSIONS

Tool to retrieve all versions of a specific Confluence page. Use to audit edit history or to get the latest version.number before calling CONFLUENCE_UPDATE_PAGE — using a stale version.number causes a 409 Conflict error.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"123e4567-e89b-12d3-a456-426614174000"

The unique identifier of the Confluence page. String format; differs from the numeric long expected by CONFLUENCE_GET_PAGE_BY_ID.

limit

integer

25

Maximum number of versions to return per page (pagination limit). Older versions are silently omitted if pagination is not followed; iterate with start and limit to retrieve full history.

start

integer

0

Zero-based index of the first version to return (pagination offset).


Confluence Get Space By Id

Integration name: CONFLUENCE_GET_SPACE_BY_ID

Tool to retrieve a Confluence space by its ID. Use when you need detailed metadata of a specific space. Space names are non-unique; use the numeric spaceId or spaceKey from the response for stable identification in downstream operations such as CONFLUENCE_GET_SPACE_PROPERTIES, CONFLUENCE_GET_LABELS_FOR_SPACE, CONFLUENCE_GET_SPACE_CONTENTS, and CONFLUENCE_CREATE_BLOGPOST.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"557060"

The numeric space ID (e.g., '557060'). This is NOT the space key (e.g., 'GTS'). Use CONFLUENCE_GET_SPACES to find a space's numeric ID from its key.


Confluence Get Space Contents

Integration name: CONFLUENCE_GET_SPACE_CONTENTS

Tool to retrieve content in a Confluence space. Use when you need to list pages, blogposts, or attachments of a specific space key. Results are in data.results (not data.page.results). Paginate via start/limit (max 200/request); follow response._links.next until absent to avoid missing content. Only returns content accessible to the authenticated user — missing items may indicate permission restrictions. Atlassian Cloud enforces HTTP 429 rate limits; throttle to ~1–2 requests/second, honor Retry-After headers, and cap start <= 1000 for large spaces. Construct item URLs by combining data._links.base with each item's _links.webui.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

type

string

"page"

Type of content to return (e.g., 'page', 'blogpost', 'attachment').

limit

integer

25

Maximum number of items to return per page. Confluence caps at 200.

start

integer

0

Zero-based index of the first item to return (pagination offset).

status

string

"current"

Status of the content to return ('current', 'trashed', 'draft', 'historical').

spaceKey

string

"DOCS"

Key of the space to retrieve content from.

postingDay

string

"2023-05-01"

For blogposts, filter by publish date (ISO date, yyyy-MM-dd).


Confluence Get Space Properties

Integration name: CONFLUENCE_GET_SPACE_PROPERTIES

Tool to get properties of a Confluence space. Use when you need to retrieve custom metadata or settings stored as space properties.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678"

ID of the space to get properties for.

key

array

["theme","sidebar"]

Filter by property key(s). If not provided, returns all properties.

limit

integer

25

Maximum number of properties to return per page. Confluence caps at 200.

start

integer

0

Zero-based index of the first item to return (pagination offset).


Confluence Get Spaces

Integration name: CONFLUENCE_GET_SPACES

Tool to retrieve a paginated list of Confluence spaces with optional filtering. Paginate by incrementing start in steps of limit until fewer results than limit are returned. Results are scoped to spaces visible to the authenticated user; absent spaces may be restricted rather than nonexistent. Use spaceKey or numeric space ID (not display name) for stable identification in downstream calls. Combined filters apply as AND logic — relax filters before concluding a space is missing.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

type

string

"global"

Type of space: global or personal.

label

array

["release","engineering"]

Filter by labels; spaces must have at least one of these labels.

limit

integer

25

Maximum number of spaces to return per page. Confluence caps at 200.

start

integer

0

Zero-based index of the first item to return (pagination offset).

expand

array

["description","icon"]

Properties to expand in response (e.g., description, icon, metadata).

status

string

"current"

Status of space: current (active) or archived.

spaceKey

array

["ABC","DEF"]

Filter by space key(s); accepts one or more space keys. Accepts canonical space keys only, not display names; if only a display name is known, list all spaces and filter client-side.


Confluence Get Tasks

Integration name: CONFLUENCE_GET_TASKS

Tool to list Confluence tasks (action items) with filtering by assignee, creator, space, page, blog post, status, and dates. Use when you need to retrieve user action items without unreliable keyword searching for "TODO".

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of tasks to return per page. Confluence caps at 250.

cursor

string

Opaque pagination cursor. Use the 'next' link from a previous response to continue.

status

string

"complete"

Filter tasks by status (e.g., 'complete', 'incomplete').

page_id

123456

Filter by page ID(s). Provide a single ID or a list of IDs.

task_id

12345

Filter by specific task ID(s). Provide a single ID or a list of IDs.

space_id

163984

Filter by space ID(s). Provide a single ID or a list of IDs.

created_by

"5d5b8c5e5c5e5c5e5c5e5c5e5c5e5c5e"

Filter by task creator(s). Provide Atlassian account ID(s).

assigned_to

"5d5b8c5e5c5e5c5e5c5e5c5e5c5e5c5e"

Filter by task assignee(s). Provide Atlassian account ID(s).

blogpost_id

987654

Filter by blog post ID(s). Provide a single ID or a list of IDs.

body_format

string

Body representation to include in task results. Allowed values: 'storage' (storage format) or 'atlas_doc_format' (Atlas document format).

completed_by

"5d5b8c5e5c5e5c5e5c5e5c5e5c5e"

Filter by who completed the task(s). Provide Atlassian account ID(s).

include_blank_tasks

boolean

Whether to include tasks that have no content or are blank.


Confluence Get User Anonymous

Integration name: CONFLUENCE_GET_USER_ANONYMOUS

Tool to retrieve information about the anonymous user. Use when you need to obtain guest user details before unauthenticated interactions.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

No parameters required.


Confluence Search Content

Integration name: CONFLUENCE_SEARCH_CONTENT

Searches for content by filtering pages from the Confluence v2 API with intelligent ranking. Since the native search endpoint is deprecated, this action:

  1. Fetches pages from the v2 pages endpoint with pagination (up to 300 pages)

  2. Applies intelligent client-side filtering with relevance scoring

  3. Returns results ranked by match quality (exact phrase > all words > partial matches)

NOTE: Only page titles are searched — queries matching only body content return no results. Results omit full body content and canonical URLs; use CONFLUENCE_GET_PAGE_BY_ID for complete page data. Cannot filter by author, date, or labels. Results reflect only pages accessible to the authenticated user. When multiple pages share similar titles, verify the correct page via spaceId or pageId before performing writes.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of results to return

query

string

"Donald Trump"

Search query to find matching pages. The search will look for this text in page titles with intelligent matching including: (1) Exact phrase matches (highest priority), (2) All words present anywhere in title (medium priority), (3) Partial word matches (lowest priority). Search is case-insensitive and supports multiple words.

start

integer

0

Starting index for pagination

expand

string

"space,version"

Comma-separated list of properties to expand in the response

spaceKey

string

"DOCS"

Limit search to a specific space by space key (will be added to CQL query) Results are not strictly scoped to this space; inspect spaceId in returned results to confirm scope.


Confluence Search Users

Integration name: CONFLUENCE_SEARCH_USERS

Searches for users using user-specific queries from the Confluence Query Language (CQL).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

limit

integer

25

Maximum number of users per result to return

cursor

string

Used for pagination. The cursor for the next page of results.

accountId

string

"712020:d844426ac4c41b0b5747ca18c540722"

Filter by user account ID


Confluence Update Blogpost

Integration name: CONFLUENCE_UPDATE_BLOGPOST

Tool to update a Confluence blog post's title or content. Use when you need to modify an existing blog post. Ensure you have the latest version number before calling.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"123e4567-e89b-12d3-a456-426614174000"

ID of the blog post to update.

body

object

{"storage":{"value":"<p>Content</p>"}}

New content for the blog post body. Provide the body in storage format.

title

string

"Updated Blog Title"

New title for the blog post.

status

string

"current"

Status of the blog post. Defaults to 'current' if not provided.

spaceId

string

"SPACE123"

ID of the space containing the blog post.

version

object

Version object containing the new version number and optional metadata.


Confluence Update Blogpost Property

Integration name: CONFLUENCE_UPDATE_BLOGPOST_PROPERTY

Tool to update a property of a specified blog post. Use when you need to modify custom metadata on a blog post.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"6278fe1e-d18f-4b2c-8a1a-2c3d4e5f6g7h"

ID of the Confluence blog post to update.

value

string

"{\"exampleKey\": \"exampleValue\"}"

New JSON string value for the specified property.

propertyId

"8093697"

The ID of the blog post property to update. Can be a numeric ID or a property key string.


Confluence Update Content Property For Page By Id

Integration name: CONFLUENCE_UPDATE_CONTENT_PROPERTY_FOR_PAGE_BY_ID

Tool to update a content property on a Confluence page. Use when you need to modify an existing metadata property by its ID.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

value

string

"{\"exampleKey\": \"exampleValue\"}"

New JSON string value for the specified property.

pageId

string

"12345678-90ab-cdef-1234-567890abcdef"

ID of the Confluence page to update the property on.

propertyId

8093697

ID of the content property to update on the page. Can be a numeric ID or a property key string.


Confluence Update Content Property For Whiteboard By Id

Integration name: CONFLUENCE_UPDATE_CONTENT_PROPERTY_FOR_WHITEBOARD_BY_ID

Tool to update a content property on a whiteboard. Use when you need to modify metadata on a Confluence whiteboard.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

value

string

"{\"status\": \"complete\"}"

New JSON string value for the specified content property.

propertyId

8093697

ID of the content property to update on the whiteboard. Can be a numeric ID or a property key string.

whiteboardId

string

"abc123-whiteboard-id"

ID of the Confluence whiteboard containing the property to update.


Confluence Update Page

Integration name: CONFLUENCE_UPDATE_PAGE

Tool to update an existing Confluence page, replacing the entire page content. Use when you need to modify existing documentation or content.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"12345678"

ID of the page to update. Must be a string; convert from numeric IDs returned by CONFLUENCE_GET_PAGE_BY_ID before passing.

body

object

Updated content body of the page. Requires 'value' (the content in the specified format) and 'representation' (either 'storage' for Confluence storage format/XHTML, or 'atlas_doc_format' for Atlassian Document Format/ADF). Replaces the entire page content — always send complete desired content. Provide exactly one representation key (storage, atlas_doc_format, or wiki) whose value matches the representation field; mismatched or multiple keys cause validation errors. Storage format requires valid XHTML/XML; malformed markup causes validation errors.

title

string

"Updated Meeting Notes"

Updated title of the page. IMPORTANT: Confluence enforces unique page titles within each space. If you change the title to one that already exists in the same space, the update will fail with a page with this title already exists error. To avoid this, either keep the existing title, choose a unique title, or first rename/delete the conflicting page.

spaceId

string

"12345678"

ID of the space containing the page. Optional if the page's space doesn't need to be changed.

version

object

Version information for the update. Must include number set to exactly current_version + 1. Fetch the current version via CONFLUENCE_GET_PAGE_BY_ID before updating. On a 409 conflict, refetch the latest version and retry.


Confluence Update Space Property

Integration name: CONFLUENCE_UPDATE_SPACE_PROPERTY

Tool to update a space property. Use when you need to modify custom metadata stored on a Confluence space (requires fetching the current property version first).

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

value

string

"{\"exampleKey\": \"exampleValue\"}"

New JSON string value for the specified space property.

spaceId

integer

1234567890

The ID of the space the property belongs to.

propertyId

1234567890

The ID of the space property to update. Can be a numeric ID or a property key string.


Confluence Update Task

Integration name: CONFLUENCE_UPDATE_TASK

Tool to update a Confluence task status. Use when you need to mark tasks as complete or incomplete in workflows or dashboards.

Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

Parameter
Type
Required
Example
Description

id

string

"123456"

ID of the task to update.

status

string

"complete"

Status of the task.

body_format

string

"storage"

Optional body format for the response.