Skip to main content
Connector guides

Connect Confluence Data Center

Confluence Data Center is Atlassian's self-hosted Confluence: the wiki you run on your own servers. This connector is for that product, not for Confluence Cloud. StackJack connects an AI assistant to…

Written By Christopher Scaminaci

Last updated 13 days ago

Confluence Data Center is Atlassian's self-hosted Confluence: the wiki you run on your own servers. This connector is for that product, not for Confluence Cloud. StackJack connects an AI assistant to your server's REST API.

Connecting Confluence Data Center to StackJack gives your AI assistant a family of confluence_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

  • Find and read knowledge - search with CQL, list and read pages, blog posts and comments, their history and versions, children and descendants, labels and properties
  • Work with spaces - list spaces and their content, trash, labels, properties, watchers and color schemes
  • Check who can do what - space and global permissions, content restrictions, users, groups and their members
  • Administer the site (on Pro plans) - create, update and delete content, attachments, spaces, users, groups, permissions and webhooks, run site and space backups and restores, and rebuild the search index
  • Inspect the server - server information, cluster nodes, instance metrics, long-running tasks, the audit log and the index status

How StackJack authenticates to Confluence

Confluence Data Center uses a personal access token (Data Center 7.9 and later), sent as a bearer token. You create it, StackJack stores it encrypted and sends it only to the address you connected.

Creating the token

  1. Sign in to Confluence as the user the token should act for.
  2. Open your profile picture menu, choose Settings, then Personal Access Tokens.
  3. Choose Create token, give it a name, optionally set an expiry, and copy the token. Confluence shows it once.

The token has the access of the user who creates it, so create it as a user whose permissions match what the AI should be able to do. The administration tools need a Confluence administrator.

Your Confluence address

Copy the address you open Confluence at, including any context path, for example https://wiki.example.com/confluence. StackJack reaches your server from the internet, so it must be reachable over HTTPS with a publicly trusted certificate. A server that is only reachable on a private network cannot be connected.

Connect it in StackJack

  1. Open Connectors, then Confluence Data Center.
  2. Enter the address in Confluence address and the token in Personal access token.
  3. Click Test connection. StackJack reads the current user. The read changes nothing.

Enter both values again whenever you save the connection, including when you only rename it.

What is worth knowing before you start

Paging

Lists take start (from 0) and limit. StackJack allows up to 1000, and your server applies its own configured maximum on top. Confluence's defaults differ by route.

Version differences

These tools follow Atlassian's Confluence 11.1.0 reference. Servers older than 9.0 do not have the backup and restore, webhook or bulk page families, so those tools answer "not found" there. Two operations that Atlassian marks as deprecated are included and say so in their descriptions.

Changing things

Tools that delete or update content, remove a watcher, change who can see or do things, manage users and groups, restore a site or a space, rebuild the search index or send content to a webhook are on the Pro tier, are marked destructive and ask for approval before they run. Updating content is on that list because Confluence deletes a draft when an update names it. Creating content, adding attachments and labels, and changing presentation settings are Pro but not destructive: Confluence keeps earlier versions. A site restore overwrites the whole site and makes it unavailable while it runs.

Files

Four tools upload a file: an attachment, a new version of an attachment, and a site or space restore from a backup zip. Give the file as base64 or as an https address StackJack fetches, up to 25 MB. A larger backup cannot be restored this way: place it in the server's restore folder and use the restore tool that names a file. The backup download tool answers a temporary download link (valid 30 minutes) for a finished backup, up to 50 MB; a larger backup is fetched from the server itself.

Passwords and credentials

The tools that create users or change passwords take a password, and the webhook tools take (and return) the receiving endpoint's credentials. StackJack never records those arguments or answers and never turns them into download links.

When Confluence refuses a call

  • The token is rejected: it is wrong, expired or revoked. Create a new token and paste it again.
  • Confluence answers as an anonymous user during the connection test: it did not recognize the token, or a proxy removed the Authorization header.
  • The user may not do that (403): the token's user lacks the permission. Create the token as a user with the access the call needs.
  • Not found (404): Confluence also answers this when the user may not view the item. Check the id or key with the list tools.
  • A conflict (409): a version conflict (read the content again and resubmit with the new version number), a duplicate title, or a job that is already running.
  • A single sign-on page answers: your proxy rejects bearer tokens. Allow the /rest/api/ path through it.
  • Rate limited: your administrator sets Data Center rate limiting. StackJack paces its calls and backs off when asked.

Plans and limits

Reads are available on the Free tier, except the backup file download, which is Pro. Changes are Pro. Business reaches the same tools as Pro and differs by monthly call quota.

See the generated Confluence Data Center tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.

Confluence Data Center tools

confluence_ · 183 tools · Free 93 · Pro 90

Attachments

ToolWhat it does
confluence_create_attachment
Pro · Write
Adds one file to a page, blog post or other content as an attachment.
confluence_delete_attachment
Pro · Destructive
DESTRUCTIVE.
confluence_delete_attachment_version
Pro · Destructive
DESTRUCTIVE.
confluence_get_attachment_extracted_text
Free · Read-only
get attachment extracted text.
confluence_list_attachments
Free · Read-only
Returns a paginated list of attachment Content entities within a single container.
confluence_move_attachment
Pro · Destructive
DESTRUCTIVE.
confluence_update_attachment_data
Pro · Write
Adds a NEW VERSION to an existing attachment: the new bytes, file name and content type replace the current ones and the earlier versions stay in the attachment's history.
confluence_update_attachment_metadata
Pro · Write
Update the non-binary data of an attachment.This resource can be used to update an attachment's filename, media-type, comment, and parent container.

Backup and restore

ToolWhat it does
confluence_cancel_all_queued_backup_jobs
Pro · Destructive
DESTRUCTIVE.
confluence_cancel_backup_job
Pro · Destructive
DESTRUCTIVE.
confluence_create_site_backup_job
Pro · Write
Starts the new site backup job.
confluence_create_site_restore_job
Pro · Destructive
DESTRUCTIVE.
confluence_create_site_restore_job_from_upload
Pro · Destructive
DESTRUCTIVE.
confluence_create_space_backup_job
Pro · Write
Creates new space backup job and adds it to the queue.
confluence_create_space_restore_job
Pro · Destructive
DESTRUCTIVE.
confluence_create_space_restore_job_from_upload
Pro · Destructive
DESTRUCTIVE.
confluence_download_backup_file
Pro · Read-only
Downloads the backup file of a FINISHED backup job.
confluence_get_backup_job
Free · Read-only
Get job by id.
confluence_list_backup_jobs
Free · Read-only
Returns jobs based on the filters provided.
confluence_list_restore_files
Free · Read-only
returns list of information on files in conf-home/restore/(jobScope).

Bulk page operations

ToolWhat it does
confluence_bulk_delete_pages
Pro · Destructive
DESTRUCTIVE.
confluence_count_deletable_descendants
Free · Read-only
Returns the number of descendant pages that the current user can delete for each of the specified pages.
confluence_get_bulk_delete_limits
Free · Read-only
Returns the limits and constraints for bulk delete operations, including the maximum number of entries allowed per request.
confluence_list_bulk_page_children
Free · Read-only
Fetches direct child pages of a parent page.
confluence_list_space_root_pages
Free · Read-only
Fetches root (top-level) pages in a space with hasChildren flags.
confluence_preview_bulk_delete
Free · Read-only
Previews a bulk delete operation without actually deleting any pages.

Content

ToolWhat it does
confluence_convert_content_body
Free · Read-only
Converts between content body representations.
confluence_count_descendant_pages
Free · Read-only
Returns the count of descendant pages for a piece of Content.
confluence_create_content
Pro · Write
Creates a new piece of Content or publishes the draft if the content id is present.
confluence_delete_content
Pro · Destructive
DESTRUCTIVE.
confluence_delete_content_version
Pro · Destructive
DESTRUCTIVE.
confluence_get_content
Free · Read-only
Returns a piece of Content.
confluence_get_content_history
Free · Read-only
Returns the history of a particular piece of content.
confluence_get_macro_body_by_hash
Free · Read-only
DEPRECATED by Atlassian.
confluence_get_macro_body_by_id
Free · Read-only
Returns the body of a macro (in storage format) with the given id.
confluence_list_child_content
Free · Read-only
Returns a map of the direct children of a piece of Content.
confluence_list_child_content_of_type
Free · Read-only
Returns the direct children of a piece of Content, limited to a single child type.The types of the children returned is specified by the "type" path parameter in the request.
confluence_list_comments
Free · Read-only
Returns the comments of a piece of Content.
confluence_list_content
Free · Read-only
Returns a paginated list of Content.
confluence_list_descendants
Free · Read-only
Returns a map of the descendants of a piece of Content.
confluence_list_descendants_of_type
Free · Read-only
Returns the direct descendants of a piece of Content.
confluence_publish_legacy_draft
Pro · Write
Publishes a legacy draft of a Content created from a ContentBlueprint.
confluence_publish_shared_draft
Pro · Write
Publishes a shared draft of a Content created from a ContentBlueprint.
confluence_scan_content
Free · Read-only
Returns a paginated list of Content.
confluence_search_content
Free · Read-only
Fetch a list of content using the Confluence Query Language (CQL).
confluence_update_content
Pro · Destructive
DESTRUCTIVE.

Index management

ToolWhat it does
confluence_get_reindex_status
Free · Read-only
Returns the current status of the most recent reindex operation.
confluence_reset_index_job
Pro · Destructive
DESTRUCTIVE.
confluence_start_reindex
Pro · Destructive
DESTRUCTIVE.
confluence_unindex_all
Pro · Destructive
DESTRUCTIVE.

Labels, properties and restrictions

ToolWhat it does
confluence_add_content_labels
Pro · Write
Adds a list of labels to the specified content.
confluence_create_content_property
Pro · Write
Creates a new content property.
confluence_create_content_property_with_key
Pro · Write
create content property with key.
confluence_delete_content_label
Pro · Destructive
DESTRUCTIVE.
confluence_delete_content_label_by_name
Pro · Destructive
DESTRUCTIVE.
confluence_delete_content_property
Pro · Destructive
DESTRUCTIVE.
confluence_get_content_property
Free · Read-only
Returns a content property.
confluence_get_content_restrictions_for_operation
Free · Read-only
Returns info about all restrictions of given operation.
confluence_list_content_labels
Free · Read-only
Returns the list of labels on a piece of Content.
confluence_list_content_properties
Free · Read-only
Returns a paginated list of content properties.
confluence_list_content_restrictions
Free · Read-only
Returns info about all restrictions by operation.
confluence_list_content_watchers
Free · Read-only
Returns a paginated list of Users watching the given Content identified by contentId.
confluence_list_relevant_view_restrictions
Free · Read-only
Returns relevant view restriction both direct and inherited for a single content.
confluence_update_content_property
Pro · Write
Updates a content property.
confluence_update_content_restrictions
Pro · Destructive
DESTRUCTIVE.

Permissions

ToolWhat it does
confluence_get_anonymous_global_permissions
Free · Read-only
Returns list of permissions granted to anonymous user.
confluence_get_anonymous_space_permissions
Free · Read-only
Returns list of permissions granted to anonymous user in the particular space.
confluence_get_group_global_permissions
Free · Read-only
Returns list of permissions granted to group.
confluence_get_group_space_permissions
Free · Read-only
Returns list of permissions granted to a group in the particular space.
confluence_get_unlicensed_global_permissions
Free · Read-only
Returns list of permissions granted to unlicensed users.
confluence_get_user_global_permissions
Free · Read-only
Returns list of permissions granted to user.
confluence_get_user_space_permissions
Free · Read-only
Returns list of permissions granted to user in the particular space.
confluence_grant_anonymous_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_grant_anonymous_space_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_grant_group_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_grant_group_space_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_grant_unlicensed_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_grant_user_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_grant_user_space_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_list_global_permissions
Free · Read-only
Returns list of permissions granted to users and groups.
confluence_list_space_permissions
Free · Read-only
Returns list of permissions granted to users and groups in the particular space.
confluence_revoke_anonymous_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_revoke_anonymous_space_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_revoke_group_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_revoke_group_space_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_revoke_unlicensed_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_revoke_user_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_revoke_user_space_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_set_global_permissions
Pro · Destructive
DESTRUCTIVE.
confluence_set_space_permissions
Pro · Destructive
DESTRUCTIVE.

Search and server

ToolWhat it does
confluence_get_access_mode
Free · Read-only
Returns the access mode status for Confluence.
confluence_get_instance_metrics
Free · Read-only
Returns simple metrics about this instance.
confluence_get_long_task
Free · Read-only
Returns information about a long-running task.
confluence_get_server_information
Free · Read-only
Returns information about the current application build running on this instance.
confluence_list_audit_records
Free · Read-only
DEPRECATED by Atlassian.
confluence_list_cluster_nodes
Free · Read-only
Returns a paginated list of information about each node in a cluster.
confluence_list_labels
Free · Read-only
Returns a paginated list of labels matching the given label name, namespace, space (via space key) or owner.
confluence_list_long_tasks
Free · Read-only
Returns information about all tracked long-running tasks.
confluence_list_popular_labels
Free · Read-only
Returns a paginated list of the most popular labels within a Confluence instance.
confluence_list_recent_labels
Free · Read-only
Returns a paginated list of recently used labels within a Confluence instance.
confluence_list_related_labels
Free · Read-only
Return a paginated list of labels related to the given label name sorted by frequency of use in descending order.
confluence_search
Free · Read-only
Search for entities in Confluence using the [Confluence Query Language (CQL)](https://developer.atlassian.com/confdev/confluence-rest-api/advanced-searching-using-cql).

Spaces

ToolWhat it does
confluence_add_space_category
Pro · Write
Adds a category the description of a given {@link Space} identified by spaceKey.
confluence_admin_create_personal_space
Pro · Destructive
DESTRUCTIVE.
confluence_archive_space
Pro · Destructive
DESTRUCTIVE.
confluence_create_personal_space
Pro · Write
Creates a personal space for self.
confluence_create_private_space
Pro · Write
Creates a new private Space, viewable only by its creator.
confluence_create_space
Pro · Write
Creates a new Space.
confluence_create_space_property
Pro · Write
Creates a new space property.
confluence_create_space_property_with_key
Pro · Write
Create a space property with a specific key.
confluence_delete_space
Pro · Destructive
DESTRUCTIVE.
confluence_delete_space_property
Pro · Destructive
DESTRUCTIVE.
confluence_get_default_color_scheme
Free · Read-only
Get default color scheme for the instance.
confluence_get_global_color_scheme
Free · Read-only
Get information about the current color scheme for the instance.
confluence_get_space
Free · Read-only
Returns information about a space.
confluence_get_space_color_scheme
Free · Read-only
Get information about the current color scheme for a space.
confluence_get_space_color_scheme_type
Free · Read-only
Get the current color scheme type used for a space, it can be global or custom.
confluence_get_space_property
Free · Read-only
Returns a space property.
confluence_list_popular_space_labels
Free · Read-only
Returns a paginated list of all Labels used by Content within the given Space.This includes Labels used by Pages, Blog Posts, and other Content types.
confluence_list_recent_space_labels
Free · Read-only
Returns a paginated list of the most recent Labels used by Content within the given Space.This includes Labels used by Pages, Blog Posts, and other Content types.
confluence_list_related_space_labels
Free · Read-only
Returns a paginated list of related Labels used by Content within the given Space.A Label is defined as being related to another when it is found attached to the same Content as the Label specified in the request.
confluence_list_space_content
Free · Read-only
Returns the content in this given space.
confluence_list_space_content_of_type
Free · Read-only
Returns the content in this given space with the given type.
confluence_list_space_labels
Free · Read-only
Returns a paginated list of all Labels used by Content within the given Space.
confluence_list_space_properties
Free · Read-only
Returns a paginated list of space properties.
confluence_list_space_trash
Free · Read-only
Returns the trash contents in this given space.
confluence_list_space_watchers
Free · Read-only
Returns a paginated list of users watching the given Space identified by spaceKey.
confluence_list_spaces
Free · Read-only
Returns information about a number of spaces.
confluence_purge_space_trash
Pro · Destructive
DESTRUCTIVE.
confluence_remove_space_category
Pro · Destructive
DESTRUCTIVE.
confluence_reset_global_color_scheme
Pro · Write
Reset the global color scheme colors to default.
confluence_reset_space_color_scheme
Pro · Write
Reset the space color scheme to use global color scheme.
confluence_restore_space
Pro · Write
Restore the given Space identified by spaceKey.
confluence_update_global_color_scheme
Pro · Write
Update the current color scheme of the instance.
confluence_update_space
Pro · Write
Updates a Space.
confluence_update_space_color_scheme
Pro · Write
Update the color scheme for a space.
confluence_update_space_color_scheme_type
Pro · Write
Update the color scheme type used for a space, currently it can be global or custom.
confluence_update_space_property
Pro · Write
Updates a space property.The body contains the representation of the space property.

Users and groups

ToolWhat it does
confluence_add_user_to_group
Pro · Destructive
DESTRUCTIVE.
confluence_admin_change_user_password
Pro · Destructive
DESTRUCTIVE.
confluence_admin_create_group
Pro · Destructive
DESTRUCTIVE.
confluence_admin_create_user
Pro · Destructive
DESTRUCTIVE.
confluence_admin_delete_group
Pro · Destructive
DESTRUCTIVE.
confluence_admin_delete_user
Pro · Destructive
DESTRUCTIVE.
confluence_admin_disable_user
Pro · Destructive
DESTRUCTIVE.
confluence_admin_enable_user
Pro · Destructive
DESTRUCTIVE.
confluence_admin_update_user
Pro · Destructive
DESTRUCTIVE.
confluence_change_current_user_password
Pro · Destructive
DESTRUCTIVE.
confluence_get_anonymous_user
Free · Read-only
Get information about how anonymous is represented in Confluence.
confluence_get_current_user
Free · Read-only
Get information about the current logged in user.
confluence_get_group
Free · Read-only
Get the user group with the group name.
confluence_get_group_by_name
Free · Read-only
Get the user group with the group name.
confluence_get_user
Free · Read-only
Get information about a user identified by either user key or username.
confluence_is_watching_content
Free · Read-only
Get information about whether a user is watching a specified content.
confluence_is_watching_space
Free · Read-only
Get information about whether a user is watching a specified space.
confluence_list_active_users
Free · Read-only
Gets a paginated collection of all active users (users which count into license usage).
confluence_list_group_ancestors
Free · Read-only
Get a collection of the specified group's direct parent groups and all its ancestors (i.e. the parents of its parents, and so on).
confluence_list_group_ancestors_by_name
Free · Read-only
Get a collection of the specified group's direct parent groups and all its ancestors (i.e. the parents of its parents, and so on).
confluence_list_group_members
Free · Read-only
**You need admin permissions to use this endpoint.** Get a paginated collection of users in the given group.
confluence_list_group_members_by_name
Free · Read-only
**You need admin permissions to use this endpoint.** Get a paginated collection of users in the given group.
confluence_list_group_parents
Free · Read-only
Get a collection of the given group's immediate parent groups.
confluence_list_group_parents_by_name
Free · Read-only
Get a collection of the given group's immediate parent groups.
confluence_list_groups
Free · Read-only
Get a paginated collection of user groups.
confluence_list_nested_group_members
Free · Read-only
Get a collection of child groups of the given group.
confluence_list_nested_group_members_by_name
Free · Read-only
Get a collection of child groups of the given group.
confluence_list_user_groups
Free · Read-only
Get a paginated collection of groups that the given user is a member of.
confluence_list_users
Free · Read-only
Gets a paginated collection of all registered users, including but not limited to: - Disabled users - Enabled users - Enabled users which count towards the license count on the site - Enabled users which do not count towards the license count on the site - Enabled users which have "can use" global permissions - Enabled users which do not have "can use" global permissions Example request URI(s): `http://example.com/confluence/rest/api/user/list` `http://example.com/confluence/rest/api/user/list?start=0` `http://example.com/confluence/rest/api/user/list?start=0&limit=100` `http://example.com/confluence/rest/api/user/list?start=0&limit=100&ex...
confluence_remove_user_from_group
Pro · Destructive
DESTRUCTIVE.
confluence_unwatch_content
Pro · Destructive
DESTRUCTIVE.
confluence_unwatch_space
Pro · Destructive
DESTRUCTIVE.
confluence_update_current_user
Pro · Write
Change the current user's details.
confluence_update_user_settings
Pro · Write
Update the specified user's settings including their prefered language setting.
confluence_watch_content
Pro · Write
Create a new watcher for the given user and content id.
confluence_watch_space
Pro · Write
Create a new watcher for the given user and space key.

Webhooks

ToolWhat it does
confluence_create_webhook
Pro · Destructive
DESTRUCTIVE.
confluence_delete_webhook
Pro · Destructive
DESTRUCTIVE.
confluence_get_webhook
Free · Read-only
Get a webhook by id.
confluence_get_webhook_latest_invocation
Free · Read-only
Get the latest invocations for a specific webhook.
confluence_get_webhook_statistics
Free · Read-only
Get the statistics for a specific webhook.
confluence_get_webhook_statistics_summary
Free · Read-only
Get the statistics summary for a specific webhook.
confluence_list_webhooks
Free · Read-only
Find webhooks.
confluence_test_webhook
Pro · Destructive
DESTRUCTIVE.
confluence_update_webhook
Pro · Destructive
DESTRUCTIVE.