# Confluence integration

### Setting up the Integration

To configure the integration, follow these simple steps:

Navigate to the integrations page in aqua.\
Choose whether you'd like to set up the integration on a **global** or **project** level. Then on 'Confluence integration' tile click the 'Configure' button.

<figure><img src="/files/hVaMIgT6vB3QFDUtBMaU" alt=""><figcaption></figcaption></figure>

Once the modal appears, plese select whether you want to set it up for cloud or Data Center version.

&#x20;

<figure><img src="/files/o9agFnMxnXfo8aE8GVQU" alt=""><figcaption></figcaption></figure>

### **Cloud version**

For Cloud version, first provide your Confluence website URL in the following format:

```
https://{website-name}.atlassian.net/wiki/
```

Then enter your Confluence user email and API key.

Click on **Check Connection** to verify your credentials. If all is good, click the 'Save' button.

<figure><img src="/files/VYgTLP7KyENWiHNcMWXk" alt=""><figcaption></figcaption></figure>

### **Data Center version**

For Data Center version, first provide your Confluence website URL in the following format:

```
https://{your domain}/
```

Then enter your PAT.

Click on **Check Connection** to verify your credentials. If all is good, click the 'Save' button.

### Linking Confluence pages

After successful setup open any aqua item and navigate to the **Dependencies** tab. Then click on the Confluence integration button located in the ribbon.

<figure><img src="/files/BjvhB20IDzTxDlwyeHvT" alt=""><figcaption></figcaption></figure>

In the modal that appears, just paste the link to the Confluence page into the corrsponding field and click the 'Link' button.

<figure><img src="/files/JlOqBEvBSnW5LkWvC01e" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Please note that you always need to copy the URL from the browser, other links from Confluence are not supported
{% endhint %}

<figure><img src="/files/MtXw6Y8uu84dnKOg1wh5" alt=""><figcaption></figcaption></figure>

If you don't have the link, you can switch to the 'Search' tab and look for pages by a keyword or page title and select one or more pages to link by clicking next to each page.

<figure><img src="/files/Eih5sqCWZMWNGkCSziIk" alt=""><figcaption></figcaption></figure>

Linked pages will be clearly displayed in both **graph** and **tree views**. Hovering over a linked page will reveal details such as the **owner** of the article and its **last modified date**.

<figure><img src="/files/nMCLuUnd3zZyX8YJX6xw" alt=""><figcaption></figcaption></figure>

#### Unlinking Confluence Pages

To remove a link:

1. Hover over the linked page node.
2. Click the corresponding **unlink icon** that appears.

#### Current Limitations

Currently, this integration supports only Confluence **Cloud** pages.&#x20;

<figure><img src="/files/LoTB1XlAjmybKFXFJpbL" alt=""><figcaption></figcaption></figure>

Support for Confluence **Data Center** is planned for an upcoming release.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/integrations/confluence-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.