Loading

Confluence Cloud connector

The Confluence Cloud connector communicates with the Confluence Cloud REST API v2 to list and retrieve spaces and pages. It uses Basic authentication (email and API token) and connects to your Atlassian site by subdomain.

You can create connectors in Stack Management > Connectors.

Confluence Cloud connectors have the following configuration properties:

Account email
Your Atlassian account email address used for Basic authentication.
Subdomain
Your Atlassian subdomain (for example, your-domain for https://your-domain.atlassian.net).
API token
Your Atlassian API token for authentication. Refer to Get API credentials for instructions.

You can test connectors when you create or edit the connector in Kibana.

The Confluence Cloud connector has the following actions:

List pages

List Confluence pages with optional filters and cursor-based pagination.

  • limit (optional): Maximum number of pages to return.
  • cursor (optional): Pagination cursor from a previous response.
  • spaceId (optional): Space ID or list of space IDs to filter by.
  • title (optional): Filter pages by title (partial match).
  • status (optional): Page status filter (for example, current, archived, draft).
  • bodyFormat (optional): Format for page body in the response (for example, atlas_doc_format, storage).
Get page

Retrieve full details of a single Confluence page by ID.

  • id (required): The ID of the page to retrieve.
  • bodyFormat (optional): Format for page body in the response.
List spaces

List Confluence spaces with optional filters and cursor-based pagination.

  • limit (optional): Maximum number of spaces to return.
  • cursor (optional): Pagination cursor from a previous response.
  • ids (optional): Space ID or list of space IDs to filter by.
  • keys (optional): Space key or list of space keys to filter by (for example, DEMO, TEAM).
  • type (optional): Space type filter (for example, global, personal).
  • status (optional): Space status filter (for example, current, archived).
Get space

Retrieve full details of a single Confluence space by ID.

  • id (required): The ID of the space to retrieve.

Use the Action configuration settings to customize connector networking, such as proxies, certificates, or TLS settings. You can set configurations that apply to all your connectors or use xpack.actions.customHostSettings to set per-host configurations.

To use the Confluence Cloud connector, you need an Atlassian API token:

  1. Log in to your Atlassian account.
  2. Go to Security > API tokens (or open API token management directly).
  3. Select Create API token.
  4. Enter a label (for example, Kibana Confluence connector) and select Create.
  5. Copy the token and store it securely. Enter this value as the API token when configuring the connector in Kibana. The email address associated with your Atlassian account is used as the username for Basic authentication.