Confluence

These are the Confluence actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• 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.

• 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.

• 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.

• Create Inline Comment

  Creates an inline comment on a Confluence page or blog post, highlighting specific text. Inline comments allow users to comment on specific portions of content without editing the page itself. Use this action when you need to add context or feedback on particular text within a page or blog post. For top-level comments, you must specify which text to highlight using inlineCommentProperties. For replies to existing inline comments, only provide the parentCommentId.

• Create Page

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

• 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.

• Create Private Space

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

• 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.

• 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.

• 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.

• Get Attachment Labels

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

• Get Attachments

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

• Get Audit Logs

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

• Get Blog Posts

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

• 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.

• 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.

• 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.

• 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.

• 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.

• 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.

• 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.

• 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.

• Get Labels for Space

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

• 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.

• 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.

• Get Page Labels

  Tool to retrieve labels of a specific Confluence page by ID. Labels are returned in `data.results

• Get Page Like Count

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

• 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.

• 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.

• 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.

• 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.

• 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.

• 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".

• 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.

• Update Page

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

• Update Task

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

• 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.

• 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.

• Create Space Property

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

• Create Whiteboard

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

• Create Whiteboard Property

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

• Delete Blogpost Property

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

• Delete Page Content Property

  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.

• Delete Space

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

• Delete Space Property

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

• Delete Whiteboard Content Property

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

• Get Anonymous User

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

• Get Blog Post Content Properties

  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.

• Get Blogpost Operations

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

• 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.

• 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.

• 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.

• Get Page Ancestors

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

• Get Page Content Properties

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

• 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.

• Get Page Inline Comments

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

• 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.

• 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.

• Search Users

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

• 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.

• Update Page Content Property

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

• 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).

• Update Whiteboard Content Property

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

These are the trigger events currently available for Confluence.

• Blog Post Added to Label

  Triggers when a new blog post is added to a specific label in Confluence.

• Blog Post Like Count Changed

  Triggers when a Confluence blog post's like count changes (someone likes or unlikes).

• Blog Post Updated

  Triggers when a Confluence blog post is updated (any edit that creates a new version).

• Blogpost Inline Comment Added

  Triggers when a new inline comment is added to a Confluence blog post.

• Content Restrictions Changed

  Triggers when view or edit restrictions change on a Confluence page or blog post. Detects user/group restrictions being added, removed, or modified.

• New Attachment Added

  Triggers when a new attachment is uploaded to a Confluence page. Optionally filters by media type.

• New Audit Log Record

  Triggers when a new audit log record is created in Confluence. Requires Confluence Standard/Premium/Enterprise plan and 'Confluence Administrator' permission.

• New Blog Post Created

  Triggers when a new blog post is created in Confluence. Optionally filters by space or status.

• New Child Page Created

  Triggers when a new child page is created under a specific parent page in Confluence.

• New CQL Content Match

  Triggers when new Confluence content appears that matches a user-provided CQL query.

• New Footer Comment Added to Page

  Triggers when a new footer comment is added to a Confluence page.

• New Inline Comment Added to Page

  Triggers when a new inline comment is added to a Confluence page.

• New Page Created

  Triggers when a new page is created in Confluence. Optionally filters by space or status.

• New Space Content Added

  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.

• New Space Created

  Triggers when a new Confluence space is created. Optionally filters by space type or status.

• New Task Created

  Triggers when a new task (action item) is created in Confluence.

• Page Content Properties Changed

  Triggers when content properties on a Confluence page are added, removed, or updated.

• Page Like Count Changed

  Triggers when a Confluence page's like count changes (someone likes or unlikes).

• Page Moved

  Triggers when a Confluence page is moved to a different location in the page hierarchy.

• Page Updated

  Triggers when a Confluence page is updated (any edit that creates a new version).

• Page Version Created

  Triggers when a new version is created for a specific Confluence page.

• Space Details Changed

  Triggers when a Confluence space's details change (name, description, status, owner, icon, etc.).

• Space Properties Changed

  Triggers when properties on a Confluence space are added, removed, or updated.