# Confluence

A tool for team collaboration and knowledge management.

- **Category:** team collaboration
- **Auth:** OAUTH2
- **Tools:** 62
- **Triggers:** 0
- **Slug:** `CONFLUENCE`
- **Version:** 20260212_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 Devcaster, see [How to create OAuth credentials for Confluence](https://devcaster.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.

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

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

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

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

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

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

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

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

### Create Space

**Slug:** `CONFLUENCE_CREATE_SPACE`

Tool to create a new Confluence space. Use when setting up a new knowledge area for organization.

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

### Create Whiteboard

**Slug:** `CONFLUENCE_CREATE_WHITEBOARD`

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

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

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

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

### Delete Page

**Slug:** `CONFLUENCE_DELETE_PAGE`

Tool to delete a Confluence page. Use with caution as this will permanently remove the page from the space.

### Delete Space

**Slug:** `CONFLUENCE_DELETE_SPACE`

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Get Current User

**Slug:** `CONFLUENCE_GET_CURRENT_USER`

Tool to get information about the currently authenticated user. Use when you need to check user details or permissions.

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

### Get Labels

**Slug:** `CONFLUENCE_GET_LABELS`

Tool to retrieve all labels in a Confluence site. Use when you need to list or page through labels.

### Get Page Labels

**Slug:** `CONFLUENCE_GET_LABELS_FOR_PAGE`

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

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

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

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

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

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

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

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

### Get Pages

**Slug:** `CONFLUENCE_GET_PAGES`

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

### Get Page Versions

**Slug:** `CONFLUENCE_GET_PAGE_VERSIONS`

Tool to retrieve all versions of a specific Confluence page. Use after confirming the page ID to audit its edit history.

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

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

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

### Get Spaces

**Slug:** `CONFLUENCE_GET_SPACES`

Tool to retrieve a list of Confluence spaces. Use when you need a paginated list of spaces with optional filtering.

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

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

### 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) The search algorithm prioritizes exact phrase matches, then checks for all query words present in the title, and finally considers partial word matches. Results are automatically sorted by relevance score for optimal user experience.

### Search Users

**Slug:** `CONFLUENCE_SEARCH_USERS`

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

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

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

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

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

### Update Page

**Slug:** `CONFLUENCE_UPDATE_PAGE`

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

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

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