# Confluence A tool for team collaboration and knowledge management. - **Category:** team collaboration - **Auth:** OAUTH2, API_KEY - **Composio Managed App Available?** Yes - **Tools:** 62 - **Triggers:** 20 - **Slug:** `CONFLUENCE` - **Version:** 20260316_00 ## Frequently Asked Questions ### How do I set up custom OAuth credentials for Confluence? For a step-by-step guide on creating and configuring your own Confluence OAuth credentials with Composio, see [How to create OAuth credentials for Confluence](https://composio.dev/auth/confluence). ## Tools ### Add Content Label **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence content (page or blog post) to label. | | `labels` | array | Yes | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### CQL Search **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cql` | string | Yes | 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 | No | Maximum number of results to return (max 250, but may be limited to 25-50 when using body expansions) | | `start` | integer | No | Starting index for pagination (0-based) | | `expand` | string | No | 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" | "indexed" | "none") | No | The type of excerpt to return. Default is 'highlight'. | | `includeArchivedSpaces` | boolean | No | Whether to include results from archived spaces | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Blogpost **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | object | Yes | 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 | Yes | The title of the new blog post. | | `status` | string ("current" | "draft") | Yes | Status of the blog post. Use `'current'` to publish immediately (publicly visible) or `'draft'` to save as private draft. | | `spaceId` | string | Yes | ID of the space where the blog post will be created. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Blogpost Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence blog post to add the property to. | | `key` | string | Yes | Unique key for the blog post property. | | `value` | string | Yes | JSON string representing the value of the blog post property. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Whiteboard Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key` | string | Yes | Key/name of the property to create. | | `value` | string | Yes | JSON string representing the value of the content property. | | `whiteboard_id` | string | Yes | ID of the whiteboard to add the property to. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Footer Comment **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | object | Yes | The body content of the comment with representation format and value. | | `pageId` | string | No | ID of the page to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId. | | `blogPostId` | string | No | ID of the blog post to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId. | | `attachmentId` | string | No | ID of the attachment to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId. | | `customContentId` | string | No | ID of the custom content to comment on. Provide one of: pageId, blogPostId, attachmentId, or customContentId. | | `parentCommentId` | string | No | ID of the parent comment. Provide this to create a reply to an existing comment. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Page **Slug:** `CONFLUENCE_CREATE_PAGE` Tool to create a new Confluence page in a specified space. Use when you need to create new documentation or content. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body` | object | No | Wrapper for page body content. | | `title` | string | Yes | 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 | Yes | 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 | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Page Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key` | string | Yes | Key/name of the property to create. | | `value` | string | Yes | Value of the property as a JSON string. Can represent any JSON type (string, number, object, array). | | `page_id` | string | Yes | ID of the page to create a property for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Private Space **Slug:** `CONFLUENCE_CREATE_PRIVATE_SPACE` Tool to create a private Confluence space. Use when you need an isolated workspace viewable only by its creator. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key` | string | Yes | A unique key for the private space; must be unique and <=255 characters. Must be alphanumeric only (no hyphens, underscores, or spaces). | | `name` | string | Yes | The name of the private space, visible only to its creator. | | `description` | object | No | Container for the plain-text description. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Space **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key` | string | Yes | 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 | Yes | Human-readable name for the space. | | `type` | string ("global" | "personal") | No | Type of the space, either 'global' or 'personal'. | | `metadata` | string | No | Optional metadata for the space as a JSON string. | | `description` | object | No | Description object for a Confluence space. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Space Property **Slug:** `CONFLUENCE_CREATE_SPACE_PROPERTY` Tool to create a new property on a Confluence space. Use after confirming the space ID when adding custom metadata. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key` | string | Yes | Unique key for the space property. | | `value` | string | Yes | JSON string representing the value of the space property. | | `spaceId` | string | Yes | ID of the space to add the property to. | | `version` | object | No | Optional version metadata for the new property. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Create Whiteboard **Slug:** `CONFLUENCE_CREATE_WHITEBOARD` Tool to create a new Confluence whiteboard. Use when you need to start a collaborative whiteboard session. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `title` | string | No | Title of the whiteboard. | | `spaceId` | string | Yes | ID of the space where the whiteboard will be created. | | `parentId` | string | No | ID of the parent content under which the whiteboard will be created. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Blogpost Property **Slug:** `CONFLUENCE_DELETE_BLOGPOST_PROPERTY` Tool to delete a blog post property. Use when you need to remove custom metadata from a specified blog post. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the Confluence blog post containing the property. | | `propertyId` | integer | Yes | The numeric Long ID of the blog post property to delete. Must be a numeric property ID, not a property key. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Page Content Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pageId` | string | Yes | ID of the Confluence page from which to delete the property. | | `propertyId` | integer | Yes | The numeric Long ID of the content property to delete from the page. Must be a numeric property ID, not a property key. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Whiteboard Content Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `propertyId` | integer | Yes | The numeric Long ID of the property to delete from the whiteboard. Must be a numeric property ID, not a property key. | | `whiteboardId` | string | Yes | ID of the whiteboard from which to delete the property. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Page **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the page to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Space **Slug:** `CONFLUENCE_DELETE_SPACE` Tool to delete a Confluence space by its key. Use when you need to permanently remove a space. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `space_key` | string | Yes | Key of the space to delete. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Delete Space Property **Slug:** `CONFLUENCE_DELETE_SPACE_PROPERTY` Tool to delete a space property. Use when you need to remove a property from a Confluence space after review. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `propertyId` | integer | Yes | The numeric Long ID of the space property to delete. Must be a numeric property ID, not a property key. | | `spaceIdOrKey` | integer | Yes | The numeric Long ID of the space containing the property. Must be a numeric space ID, not a space key or UUID. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Download Attachment **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `pageId` | string | Yes | ID of the Confluence page that contains the attachment. | | `attachmentId` | string | Yes | ID of the attachment to download (e.g., 'att65825'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Attachment Labels **Slug:** `CONFLUENCE_GET_ATTACHMENT_LABELS` Tool to list labels on an attachment. Use after confirming the attachment ID to fetch its labels. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence attachment to retrieve labels for. | | `sort` | string | No | Sort the result by a particular field. | | `limit` | integer | No | Maximum number of labels to return per page (1-250). | | `cursor` | string | No | Opaque cursor for pagination. Returned in the Link response header for fetching the next page. | | `prefix` | string ("my" | "team" | "global" | "system") | No | Filter labels by their prefix. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Attachments **Slug:** `CONFLUENCE_GET_ATTACHMENTS` Tool to retrieve attachments of a Confluence page. Use after confirming page ID to list its attachments (supports pagination). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of attachments to return per page. Confluence caps at 200. | | `start` | integer | No | Zero-based index of the first item to return (pagination offset). | | `pageId` | string | Yes | ID of the Confluence page whose attachments will be retrieved. | | `mediaType` | string | No | Filter attachments by MIME type (e.g., 'image/png', 'application/pdf'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Audit Logs **Slug:** `CONFLUENCE_GET_AUDIT_LOGS` Tool to retrieve Confluence audit records. Use when you need to fetch and filter audit logs for compliance or troubleshooting. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of audit records to return per page. | | `start` | integer | No | Zero-based index of the first audit record to return (pagination offset). | | `endDate` | integer | No | End of the audit record timestamp range (epoch time in milliseconds). | | `startDate` | integer | No | Start of the audit record timestamp range (epoch time in milliseconds). | | `searchString` | string | No | Free-text search to filter audit records by summary or category. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blogpost by ID **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Unique identifier of the Confluence blog post to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blogpost Labels **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence blog post to retrieve labels for. | | `limit` | integer | No | Maximum number of labels to return per page. | | `start` | integer | No | Zero-based index of the first label to return (pagination offset). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blogpost Like Count **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence blog post to retrieve like count for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blogpost Operations **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence blog post to query operations for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blog Posts **Slug:** `CONFLUENCE_GET_BLOG_POSTS` Tool to retrieve a list of blog posts. Use when you need a paginated list of Confluence blog posts. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of items to return per page. | | `cursor` | string | No | Opaque pagination cursor for fetching the next page of results. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blog Posts For Label **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the label to retrieve blog posts for. | | `limit` | integer | No | Maximum number of items to return per page. | | `cursor` | string | No | Opaque pagination cursor for fetching the next page of results. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blogpost Version Details **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blogpostId` | string | Yes | Unique identifier of the Confluence blog post. | | `versionNumber` | integer | Yes | Version number of the blog post to retrieve. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blogpost Versions **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of version items to return per page. | | `cursor` | string | No | Cursor for pagination. Use value from previous response to fetch next page. | | `blogpostId` | string | Yes | The unique identifier of the Confluence blog post. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Child Pages **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | 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 ("id" | "-id" | "created-date" | "-created-date" | "modified-date" | "-modified-date" | "child-position" | "-child-position") | No | Sort order options for child pages. | | `limit` | integer | No | 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 | No | Cursor for pagination. Use the cursor from the previous response's _links.next to get the next page of results. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Blog Post Content Properties **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of properties to return per page. | | `start` | integer | No | Zero-based index of the first property to return (pagination offset). | | `blogpost_id` | string | Yes | Identifier of the Confluence blog post to retrieve properties for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Content Properties **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of properties to return per page (max 200). | | `cursor` | string | No | Opaque pagination cursor for fetching the next page of results. | | `page_id` | string | Yes | Identifier of the Confluence page to retrieve properties for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Content Restrictions **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the content to retrieve restrictions for. | | `expand` | array | No | Comma-separated properties to expand in the response, e.g., ['restrictables.operation', 'user'] | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Current User **Slug:** `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. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Inline Comments for Blog Post **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Unique identifier of the blog post to retrieve inline comments for. | | `sort` | string ("created-date" | "-created-date" | "modified-date" | "-modified-date") | No | Sort order for results. Use '-' prefix for descending order. | | `limit` | integer | No | Maximum number of inline comments to return per page (default 25, max 250). | | `cursor` | string | No | Cursor for pagination. Use the cursor from _links.next in the previous response to get the next page. | | `body_format` | string ("storage" | "atlas_doc_format") | No | The content format type for the comment body. Valid values: storage, atlas_doc_format. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Labels **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of labels to return per page. | | `start` | integer | No | Zero-based index of the first label to return (pagination offset). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Labels **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence page to retrieve labels for. | | `limit` | integer | No | Maximum number of labels to return per page. | | `start` | integer | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Labels for Space **Slug:** `CONFLUENCE_GET_LABELS_FOR_SPACE` Tool to list labels on a space. Use when you need to retrieve labels for a specific space. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the space to retrieve labels for (numeric space ID). | | `sort` | string ("created-date" | "-created-date" | "id" | "-id" | "name" | "-name") | No | Sort order for results. Use '-' prefix for descending order. | | `limit` | integer | No | Maximum number of labels to return per page (default 25, max 250). | | `cursor` | string | No | Cursor for pagination. Use the cursor from the previous response to get the next page. | | `prefix` | string ("my" | "team" | "global" | "system") | No | Filter labels by prefix. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Labels for Space Content **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The ID of the space to list content labels for. | | `limit` | integer | No | Maximum number of labels to return per page. | | `start` | integer | No | Zero-based index of the first label to return (pagination offset). | | `prefix` | string | No | Filter labels by this prefix (e.g., 'global', 'page-'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Ancestors **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the Confluence page to retrieve ancestors for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page by ID **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | integer | Yes | 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 | No | Whether to return the draft version (default: false). | | `version` | integer | No | Specific page version to retrieve (default: latest). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Footer Comments **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Unique identifier of the page to retrieve footer comments for. | | `sort` | string ("created-date" | "-created-date" | "modified-date" | "-modified-date") | No | Sort order for results. Use '-' prefix for descending order. | | `limit` | integer | No | Maximum number of footer comments to return per page (default 50, max 250). | | `cursor` | string | No | Cursor for pagination. Use the cursor from _links.next in the previous response to get the next page. | | `status` | array | No | Filter comments by status. Can include multiple statuses. | | `body_format` | string ("storage" | "atlas_doc_format") | No | The content format type for the comment body. Valid values: storage, atlas_doc_format. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Inline Comments **Slug:** `CONFLUENCE_GET_PAGE_INLINE_COMMENTS` Tool to retrieve inline comments for a Confluence page. Use when you need inline comment details by page ID. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | integer | Yes | Numeric ID of the page to retrieve inline comments for. | | `sort` | string ("created-date" | "-created-date" | "modified-date" | "-modified-date") | No | Sort order for results. Use '-' prefix for descending order. | | `limit` | integer | No | Maximum number of inline comments to return per page (default 25, max 250). | | `cursor` | string | No | Cursor for pagination. Use the cursor from _links.next in the previous response to get the next page. | | `status` | array | No | Filter comments by status. Pass an array of status values. | | `body_format` | string ("storage" | "atlas_doc_format") | No | The content format type for the comment body. Valid values: storage, atlas_doc_format. | | `resolution_status` | array | No | Filter comments by resolution status. Pass an array of resolution status values (e.g., 'open', 'resolved'). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Like Count **Slug:** `CONFLUENCE_GET_PAGE_LIKE_COUNT` Tool to get like count for a Confluence page. Use after confirming the page ID to retrieve total likes. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | Identifier of the Confluence page to retrieve like count for. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Pages **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `sort` | string ("id" | "-id" | "created-date" | "-created-date" | "modified-date" | "-modified-date" | "title" | "-title") | No | Sort order for Confluence pages using AbstractPageSortOrder enum values. | | `limit` | integer | No | Maximum number of pages to return per page. Confluence caps at 250. | | `title` | string | No | Filter by page title (exact match). | | `cursor` | string | No | 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` | string | No | Filter by page status. Allowed values: current, archived, deleted, trashed. | | `spaceId` | string | No | Filter by space ID(s). Provide a single ID or a list of IDs. | | `subtype` | string | No | Filter by page subtype. Valid values: live, page. | | `body_format` | string ("storage" | "atlas_doc_format") | No | Body representation to include in results. Allowed values: 'storage' (storage format) or 'atlas_doc_format' (Atlas document format). The value 'view' is not supported. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Page Versions **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | The unique identifier of the Confluence page. String format; differs from the numeric long expected by CONFLUENCE_GET_PAGE_BY_ID. | | `limit` | integer | No | 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 | No | Zero-based index of the first version to return (pagination offset). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Space by ID **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Space Contents **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("page" | "blogpost" | "attachment") | No | Type of content to return (e.g., 'page', 'blogpost', 'attachment'). | | `limit` | integer | No | Maximum number of items to return per page. Confluence caps at 200. | | `start` | integer | No | Zero-based index of the first item to return (pagination offset). | | `status` | string ("current" | "trashed" | "draft" | "historical") | No | Status of the content to return ('current', 'trashed', 'draft', 'historical'). | | `spaceKey` | string | Yes | Key of the space to retrieve content from. | | `postingDay` | string | No | For blogposts, filter by publish date (ISO date, yyyy-MM-dd). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Space Properties **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the space to get properties for. | | `key` | array | No | Filter by property key(s). If not provided, returns all properties. | | `limit` | integer | No | Maximum number of properties to return per page. Confluence caps at 200. | | `start` | integer | No | Zero-based index of the first item to return (pagination offset). | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Spaces **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `type` | string ("global" | "personal") | No | Type of space: 'global' or 'personal'. | | `label` | array | No | Filter by labels; spaces must have at least one of these labels. | | `limit` | integer | No | Maximum number of spaces to return per page. Confluence caps at 200. | | `start` | integer | No | Zero-based index of the first item to return (pagination offset). | | `expand` | array | No | Properties to expand in response (e.g., 'description', 'icon', 'metadata'). | | `status` | string ("current" | "archived") | No | Status of space: 'current' (active) or 'archived'. | | `spaceKey` | array | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Tasks **Slug:** `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". #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of tasks to return per page. Confluence caps at 250. | | `cursor` | string | No | Opaque pagination cursor. Use the 'next' link from a previous response to continue. | | `status` | string | No | Filter tasks by status (e.g., 'complete', 'incomplete'). | | `page_id` | string | No | Filter by page ID(s). Provide a single ID or a list of IDs. | | `task_id` | string | No | Filter by specific task ID(s). Provide a single ID or a list of IDs. | | `space_id` | string | No | Filter by space ID(s). Provide a single ID or a list of IDs. | | `created_by` | string | No | Filter by task creator(s). Provide Atlassian account ID(s). | | `assigned_to` | string | No | Filter by task assignee(s). Provide Atlassian account ID(s). | | `blogpost_id` | string | No | Filter by blog post ID(s). Provide a single ID or a list of IDs. | | `body_format` | string ("storage" | "atlas_doc_format") | No | Body representation to include in task results. Allowed values: 'storage' (storage format) or 'atlas_doc_format' (Atlas document format). | | `completed_by` | string | No | Filter by who completed the task(s). Provide Atlassian account ID(s). | | `include_blank_tasks` | boolean | No | Whether to include tasks that have no content or are blank. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Get Anonymous User **Slug:** `CONFLUENCE_GET_USER_ANONYMOUS` Tool to retrieve information about the anonymous user. Use when you need to obtain guest user details before unauthenticated interactions. #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search Content **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of results to return | | `query` | string | Yes | 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 | No | Starting index for pagination | | `expand` | string | No | Comma-separated list of properties to expand in the response | | `spaceKey` | string | No | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Search Users **Slug:** `CONFLUENCE_SEARCH_USERS` Searches for users using user-specific queries from the Confluence Query Language (CQL). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `limit` | integer | No | Maximum number of users per result to return | | `cursor` | string | No | Used for pagination. The cursor for the next page of results. | | `accountId` | string | No | Filter by user account ID | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Blogpost **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the blog post to update. | | `body` | object | Yes | New content for the blog post body. Provide the body in storage format. | | `title` | string | Yes | New title for the blog post. | | `status` | string ("current" | "draft" | "archived") | No | Status of the blog post. Defaults to 'current' if not provided. | | `spaceId` | string | Yes | ID of the space containing the blog post. | | `version` | object | Yes | Version object containing the new version number and optional metadata. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Blogpost Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the Confluence blog post to update. | | `value` | string | Yes | New JSON string value for the specified property. | | `propertyId` | integer | Yes | The numeric Long ID of the blog post property to update. Must be a numeric property ID, not a property key. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Page Content Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | New JSON string value for the specified property. | | `pageId` | string | Yes | ID of the Confluence page to update the property on. | | `propertyId` | string | Yes | ID of the content property to update on the page. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Whiteboard Content Property **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | New JSON string value for the specified content property. | | `propertyId` | string | Yes | ID of the content property to update on the whiteboard. | | `whiteboardId` | string | Yes | ID of the Confluence whiteboard containing the property to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Page **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | 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 | Yes | 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 | Yes | 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 | No | ID of the space containing the page. Optional if the page's space doesn't need to be changed. | | `version` | object | Yes | 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. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Space Property **Slug:** `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). #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `value` | string | Yes | New JSON string value for the specified space property. | | `spaceId` | integer | Yes | The ID of the space the property belongs to. | | `propertyId` | integer | Yes | The ID of the space property to update. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ### Update Task **Slug:** `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. #### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `id` | string | Yes | ID of the task to update. | | `status` | string ("complete" | "incomplete") | Yes | Status of the task. | | `body_format` | string ("storage" | "atlas_doc_format") | No | Optional body format for the response. | #### Output | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `data` | string | Yes | Data from the action execution | | `error` | string | No | Error if any occurred during the execution of the action | | `successful` | boolean | Yes | Whether or not the action execution was successful or not | ## Triggers ### New Attachment Added **Slug:** `CONFLUENCE_ATTACHMENT_ADDED_TRIGGER` **Type:** poll Triggers when a new attachment is uploaded to a Confluence page. Optionally filters by media type. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of attachments to check in each poll (1-200). Default is 25. | | `mediaType` | string | No | Filter attachments by MIME type (e.g., 'image/png', 'application/pdf'). Leave empty to monitor all types. | | `pageId` | string | Yes | ID of the Confluence page to monitor for new attachments. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `attachment` | object | Yes | The newly added Confluence attachment | | `event_type` | string | No | Type of event that occurred | ### Blog Post Added to Label **Slug:** `CONFLUENCE_BLOG_POST_ADDED_TO_LABEL_TRIGGER` **Type:** poll Triggers when a new blog post is added to a specific label in Confluence. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `label_id` | string | Yes | ID of the label to monitor for new blog posts. | | `limit` | integer | No | Maximum number of blog posts to fetch in each poll. Default is 25, max is 250. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blog_post` | object | Yes | The newly added blog post to the label | | `event_type` | string | No | Type of event that occurred | ### Blogpost Inline Comment Added **Slug:** `CONFLUENCE_BLOGPOST_INLINE_COMMENT_ADDED_TRIGGER` **Type:** poll Triggers when a new inline comment is added to a Confluence blog post. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blog_post_id` | string | Yes | The ID of the blog post to monitor for new inline comments | | `body_format` | string ("storage" | "atlas_doc_format") | No | The content format type for the comment body. Valid values: storage, atlas_doc_format. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of inline comments to fetch per poll (default 25, max 250) | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `comment` | object | Yes | The newly added inline comment | | `event_type` | string | No | Type of event that occurred | ### Blog Post Like Count Changed **Slug:** `CONFLUENCE_BLOGPOST_LIKE_COUNT_CHANGED_TRIGGER` **Type:** poll Triggers when a Confluence blog post's like count changes (someone likes or unlikes). #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blogpost_id` | string | Yes | The unique ID of the Confluence blog post to monitor for like count changes. Use CONFLUENCE_GET_BLOG_POSTS to find blog post IDs. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blogpost_id` | string | Yes | The ID of the blog post | | `change` | integer | Yes | The change in like count (positive for likes, negative for unlikes) | | `current_like_count` | integer | Yes | Current like count after the change | | `event_type` | string | No | Type of event that occurred | | `previous_like_count` | integer | Yes | Previous like count before the change | ### Blog Post Updated **Slug:** `CONFLUENCE_BLOGPOST_UPDATED_TRIGGER` **Type:** poll Triggers when a Confluence blog post is updated (any edit that creates a new version). #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blogpost_id` | string | Yes | The unique ID of the Confluence blog post to monitor for updates. Use CONFLUENCE_GET_BLOG_POSTS to find blog post IDs. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blog_post` | object | Yes | The updated blog post | | `current_version` | integer | Yes | Current version number after the update | | `event_type` | string | No | Type of event that occurred | | `previous_version` | integer | Yes | Previous version number before the update | ### Content Restrictions Changed **Slug:** `CONFLUENCE_CONTENT_RESTRICTIONS_CHANGED_TRIGGER` **Type:** poll Triggers when view or edit restrictions change on a Confluence page or blog post. Detects user/group restrictions being added, removed, or modified. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `content_id` | string | Yes | The unique ID of the Confluence page or blog post to monitor for restriction changes. Use CONFLUENCE_GET_PAGES or CONFLUENCE_GET_BLOG_POSTS to find content IDs. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `content_id` | string | Yes | ID of the content whose restrictions changed | | `current_hash` | string | No | Current restrictions hash | | `current_restrictions` | array | Yes | Current restriction state | | `event_type` | string | No | Type of event that occurred | | `previous_hash` | string | No | Previous restrictions hash | | `previous_restrictions` | array | Yes | Previous restriction state | | `restrictions_hash_changed` | boolean | Yes | Whether the restrictions hash changed | ### New Footer Comment Added to Page **Slug:** `CONFLUENCE_FOOTER_COMMENT_ADDED_TRIGGER` **Type:** poll Triggers when a new footer comment is added to a Confluence page. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body_format` | string ("storage" | "atlas_doc_format") | No | The content format type for the comment body. Valid values: storage, atlas_doc_format. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of footer comments to fetch per poll (default 25, max 250) | | `page_id` | string | Yes | The ID of the page to monitor for new footer comments | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `comment` | object | Yes | The newly added footer comment | | `event_type` | string | No | Type of event that occurred | ### New Audit Log Record **Slug:** `CONFLUENCE_NEW_AUDIT_LOG_TRIGGER` **Type:** poll Triggers when a new audit log record is created in Confluence. Requires Confluence Standard/Premium/Enterprise plan and 'Confluence Administrator' permission. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of audit records to check in each poll (1-1000) | | `search_string` | string | No | Optional search string to filter audit records by summary or category. Leave empty to monitor all audit records. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `audit_record` | object | Yes | The newly created audit log record | | `event_type` | string | No | Type of event that occurred | ### New Blog Post Created **Slug:** `CONFLUENCE_NEW_BLOG_POST_CREATED_TRIGGER` **Type:** poll Triggers when a new blog post is created in Confluence. Optionally filters by space or status. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of blog posts to fetch in each poll (1-250). Default is 25. | | `space_id` | string | No | Filter blog posts by specific space ID. Leave empty to monitor all spaces. | | `status` | string | No | Filter blog posts by status (e.g., 'current', 'archived'). Leave empty to monitor all statuses. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blog_post` | object | Yes | The newly created blog post | | `event_type` | string | No | Type of event that occurred | ### New Child Page Created **Slug:** `CONFLUENCE_NEW_CHILD_PAGE_TRIGGER` **Type:** poll Triggers when a new child page is created under a specific parent page in Confluence. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of child pages to check in each poll (1-250). Default is 25. | | `parent_page_id` | string | Yes | ID of the parent Confluence page to monitor for new child pages. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `child_page` | object | Yes | The newly created child page | | `event_type` | string | No | Type of event that occurred | | `parent_page_id` | string | Yes | ID of the parent page under which the child was created | ### New CQL Content Match **Slug:** `CONFLUENCE_NEW_CQL_CONTENT_MATCH_TRIGGER` **Type:** poll Triggers when new Confluence content appears that matches a user-provided CQL query. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `cql_query` | string | Yes | Confluence Query Language (CQL) query to search for content. Examples: 'label = "important"' (content with specific label), 'text ~ "API documentation"' (full-text search), 'type = page AND space = DEV' (pages in DEV space), 'type = blogpost AND lastModified > now("-7d")' (recent blog posts). The trigger will fire when new content matches this query. | | `expand` | string | No | Comma-separated list of properties to expand in the response. Common values: 'content.space', 'content.version', 'content.body.storage'. Note: Using body expansions may limit results to 25-50. | | `includeArchivedSpaces` | boolean | No | Whether to include results from archived spaces | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of results to fetch in each poll (1-250). Default is 25. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `event_type` | string | No | Type of event that occurred | | `result` | object | Yes | The search result that newly matched the query | ### New Task Created **Slug:** `CONFLUENCE_NEW_TASK_CREATED_TRIGGER` **Type:** poll Triggers when a new task (action item) is created in Confluence. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `blogpost_id` | integer | No | Filter tasks by specific blog post ID. Leave empty to monitor all blog posts. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of tasks to fetch in each poll. Confluence caps at 250. | | `page_id` | integer | No | Filter tasks by specific page ID. Leave empty to monitor all pages. | | `space_id` | integer | No | Filter tasks by specific space ID. Leave empty to monitor all spaces. | | `status` | string | No | Filter tasks by status (e.g., 'complete', 'incomplete'). Leave empty to monitor all statuses. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `event_type` | string | No | Type of event that occurred | | `task` | object | Yes | The newly created task | ### Page Content Properties Changed **Slug:** `CONFLUENCE_PAGE_CONTENT_PROPERTIES_CHANGED_TRIGGER` **Type:** poll Triggers when content properties on a Confluence page are added, removed, or updated. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of properties to fetch in each poll (1-200). Default is 100. | | `page_id` | string | Yes | The ID of the Confluence page to monitor for content property changes. Use CONFLUENCE_GET_PAGES or CONFLUENCE_GET_PAGE_BY_ID to find page IDs. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `added_properties` | array | No | List of properties that were added | | `event_type` | string | No | Type of event that occurred | | `page_id` | string | Yes | ID of the page whose properties changed | | `removed_properties` | array | No | List of properties that were removed | | `updated_properties` | array | No | List of properties that were updated with old and new values | ### New Page Created **Slug:** `CONFLUENCE_PAGE_CREATED_TRIGGER` **Type:** poll Triggers when a new page is created in Confluence. Optionally filters by space or status. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of pages to fetch in each poll (1-250). Default is 25. | | `space_id` | integer | No | Filter pages by specific space ID. Leave empty to monitor all spaces. | | `status` | string | No | Filter pages by status (e.g., 'current', 'archived', 'deleted', 'trashed'). Leave empty to monitor all statuses. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `event_type` | string | No | Type of event that occurred | | `page` | object | Yes | The newly created page | ### New Inline Comment Added to Page **Slug:** `CONFLUENCE_PAGE_INLINE_COMMENT_ADDED_TRIGGER` **Type:** poll Triggers when a new inline comment is added to a Confluence page. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `body_format` | string ("storage" | "atlas_doc_format") | No | The content format type for the comment body. Valid values: storage, atlas_doc_format. | | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of inline comments to fetch per poll (default 25, max 250) | | `page_id` | integer | Yes | The ID of the page to monitor for new inline comments | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `comment` | object | Yes | The newly added inline comment | | `event_type` | string | No | Type of event that occurred | ### Page Like Count Changed **Slug:** `CONFLUENCE_PAGE_LIKE_COUNT_CHANGED_TRIGGER` **Type:** poll Triggers when a Confluence page's like count changes (someone likes or unlikes). #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `page_id` | string | Yes | The unique ID of the Confluence page to monitor for like count changes. Use CONFLUENCE_GET_PAGES to find page IDs. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `change_delta` | integer | Yes | The change in like count (positive for likes, negative for unlikes) | | `current_count` | integer | Yes | Current number of likes after the change | | `event_type` | string | No | Type of event that occurred | | `page_id` | string | Yes | The ID of the page whose like count changed | | `previous_count` | integer | Yes | Previous number of likes before the change | ### Page Moved **Slug:** `CONFLUENCE_PAGE_MOVED_TRIGGER` **Type:** poll Triggers when a Confluence page is moved to a different location in the page hierarchy. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `page_id` | string | Yes | The ID of the Confluence page to monitor for moves (e.g., '66304'). Use CONFLUENCE_GET_PAGES to find page IDs. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `event_type` | string | No | Type of event that occurred | | `new_ancestors` | array | Yes | New ancestor chain (ordered from root to immediate parent) | | `old_ancestors` | array | Yes | Previous ancestor chain (ordered from root to immediate parent) | | `page_id` | string | Yes | ID of the page that was moved | ### Page Updated **Slug:** `CONFLUENCE_PAGE_UPDATED_TRIGGER` **Type:** poll Triggers when a Confluence page is updated (any edit that creates a new version). #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `page_id` | string | Yes | The unique ID of the Confluence page to monitor for updates. Use CONFLUENCE_GET_PAGES to find page IDs. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `current_version` | integer | Yes | Current version number after the update | | `event_type` | string | No | Type of event that occurred | | `page` | object | Yes | The updated page | | `previous_version` | integer | Yes | Previous version number before the update | ### Page Version Created **Slug:** `CONFLUENCE_PAGE_VERSION_CREATED_TRIGGER` **Type:** poll Triggers when a new version is created for a specific Confluence page. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of versions to fetch in each poll (1-200). Default is 25. | | `page_id` | string | Yes | The ID of the page to monitor for new versions. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `event_type` | string | No | Type of event that occurred | | `version` | object | Yes | The newly created page version | ### New Space Content Added **Slug:** `CONFLUENCE_SPACE_CONTENT_ADDED_TRIGGER` **Type:** poll Triggers when new content (pages or blog posts) is added to a Confluence space. Attachments are not supported at space level; use the 'New Attachment Added' trigger instead. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of items to check in each poll (1-200). Default is 25. | | `space_id` | integer | No | Numeric ID of the Confluence space to monitor for new content. Leave empty to monitor all spaces. | | `status` | string | No | Status of the content to monitor ('current', 'trashed', 'draft', 'historical'). Default is 'current'. | | `type` | string | No | Type of content to monitor: 'page' or 'blogpost'. Leave empty to monitor all types (pages and blogposts). Note: Attachments are not supported at space level; use the 'New Attachment Added' trigger instead. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `content` | object | Yes | The newly added Confluence content | | `event_type` | string | No | Type of event that occurred | ### New Space Created **Slug:** `CONFLUENCE_SPACE_CREATED_TRIGGER` **Type:** poll Triggers when a new Confluence space is created. Optionally filters by space type or status. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of spaces to check in each poll (1-200). Default is 25. | | `space_type` | string | No | Filter by space type: 'global', 'personal', or 'collaboration'. Leave empty to monitor all types. | | `status` | string | No | Filter by space status: 'current' or 'archived'. Leave empty to monitor all statuses. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `event_type` | string | No | Type of event that occurred | | `space` | object | Yes | The newly created Confluence space | ### Space Details Changed **Slug:** `CONFLUENCE_SPACE_DETAILS_CHANGED_TRIGGER` **Type:** poll Triggers when a Confluence space's details change (name, description, status, owner, icon, etc.). #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `space_id` | string | Yes | The numeric ID of the Confluence space to monitor for changes (e.g., '196612'). Use CONFLUENCE_GET_SPACES to find space IDs. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `changed_fields` | object | Yes | Dictionary of changed fields with 'old' and 'new' values | | `event_type` | string | No | Type of event that occurred | | `space` | object | Yes | The updated Confluence space details | ### Space Properties Changed **Slug:** `CONFLUENCE_SPACE_PROPERTIES_CHANGED_TRIGGER` **Type:** poll Triggers when properties on a Confluence space are added, removed, or updated. #### Configuration | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `interval` | number | No | Periodic Interval to Check for Updates & Send a Trigger in Minutes | | `limit` | integer | No | Maximum number of properties to fetch in each poll (1-200). Default is 100. | | `space_id` | string | Yes | The ID of the Confluence space to monitor for property changes. Use CONFLUENCE_GET_SPACES to find space IDs. | #### Payload | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `added_properties` | array | No | List of properties that were added | | `event_type` | string | No | Type of event that occurred | | `removed_properties` | array | No | List of properties that were removed | | `space_id` | string | Yes | ID of the space whose properties changed | | `updated_properties` | array | No | List of properties that were updated with old and new values |