# Atlassian

### Overview

The Atlassian integration connects nexos.ai with **Jira** and **Confluence** so you can search for and reference tickets and pages directly in your workspace. It helps you answer questions faster, summarize project context, and keep responses grounded in the same source of truth your team already uses.

### Setting up the integration (organization admin)

1. Open **Settings**.
2. Go to **Organization** → **Integrations**.
3. Find **Atlassian** in the list.
4. Set the integration to **Active** (enabled).

After it’s enabled here, team members can connect their own Atlassian accounts.

<figure><img src="/files/EJx3fYkSyYzWTl3vcoyN" alt="" width="563"><figcaption></figcaption></figure>

### Connecting your account

1. Open **Settings** (select your email/profile at the bottom of the left sidebar, then **Settings**).
2. Select **My Integrations**.
3. Find **Atlassian** and select **Connect**.

<figure><img src="/files/0FI3XyrhEzL2fiUHsq2k" alt="" width="563"><figcaption></figcaption></figure>

4. You will be redirected to Atlassian. Sign in if prompted.
5. Review the access request screen (it will list what nexos.ai can access in **Jira** and **Confluence**) and select **Accept** to approve.

<figure><img src="/files/iOr0s6ARi7oY3c2LCQhL" alt="" width="563"><figcaption></figcaption></figure>

6. Return to nexos.ai. Atlassian should now show as connected in **My Integrations**.

<figure><img src="/files/kCjsondA0kMt0elKKOjB" alt="" width="563"><figcaption></figcaption></figure>

### Use Atlassian in Chat (turn it on for a conversation)

1. Open **Chat**.
2. Select the **Tools** icon.
3. Turn **Atlassian** **toggle** **on** to use it in that conversation.

<figure><img src="/files/uUb0Gs5nspHuWahg90ZG" alt="" width="563"><figcaption></figcaption></figure>

### Use Atlassian in Agents (turn it on for an agent)

1. Open **Agents** and select the agent you want to update.
2. Select the **Studio** icon (top-right), then open **Settings**.
3. Scroll to **Integrations** and turn **Atlassian** **on**.
4. **Save** your changes, then test the agent by asking it to pull context from Jira or Confluence (for example, “Summarize this Jira ticket” or “Find and summarize the Confluence page about X”).

<figure><img src="/files/7zEzG3VsIsaEykgaabHL" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Alternative (quick method)**\
You can also tell the agent in plain language to add the Atlassian integration (for example, “Add the Atlassian integration for this agent”), and it will enable Atlassian for itself automatically so you can continue without leaving the conversation.
{% endhint %}

### Managing permissions&#x20;

* Your access in nexos.ai matches what your Atlassian account can access in Jira and Confluence. If you cannot find a project, issue, or space, you likely do not have permission for it in Atlassian.
* If the integration stops working or content disappears, reconnect your account (select **Connect** again) to refresh access.


---

# 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.nexos.ai/workspace/integrations/atlassian.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.