# 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](https://toolhouse.app/auth-connections?authkit_slugs=confluence).
## 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. |
***
### `Confluence Cql Search`
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. |
***
### `Confluence Create Footer Comment`
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). |
***
### `Confluence Get Page Footer Comments`
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":"Content
"}}` | 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. |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.toolhouse.ai/toolhouse/integrations/confluence.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.