# Atlassian

## Overview

Atlassian provides a suite of collaboration tools including Jira for issue tracking and project management and Confluence for documentation and knowledge management. By connecting Suger to Atlassian, the Suger AI agent can create and update Jira issues and Confluence pages and automate your team's project and documentation workflows.

### Org-Level vs User-Level

> **User-Level Only**: Atlassian integration is configured per user. Each user authenticates with their own Atlassian account via OAuth.

## Create User Integration

### Authenticate

1. Navigate to Settings > Integrations > User Integrations
2. Click `Connect Now` in the Atlassian section
3. You will be redirected to Atlassian to authorize
4. Grant access to your Atlassian workspace
5. Return to Suger to confirm the connection

:::note
Each user connects their own Atlassian account. The integration uses OAuth to authenticate with Atlassian.
:::

## Suger AI Tools

When Atlassian is connected, the Suger AI agent can work across Jira and Confluence through Suger's built-in tools (78 actions). Capabilities are grouped below.

> **User-level**: Each user connects their own Atlassian account; multi-site access is resolved via the connected account's accessible resources.

| Capability | What the agent can do |
|------------|-----------------------|
| **Jira issues** | Create, read, update, link, and search issues with JQL (e.g. `jira-create-issue`, `jira-search-issues`, `jira-create-issue-link`) |
| **Jira workflow & comments** | Transition issues and add comments, worklogs, watchers, and attachments (e.g. `jira-transition-issue`, `jira-add-comment`, `jira-add-worklog`) |
| **Jira projects & metadata** | Read projects, fields, statuses, priorities, and issue types (e.g. `jira-list-projects`, `jira-list-fields`, `jira-get-create-issue-metadata`) |
| **Confluence pages & blog posts** | Create, update, and search pages and blog posts (e.g. `confluence-create-page`, `confluence-update-page`, `confluence-search-content`) |
| **Confluence comments & properties** | Add footer and inline comments and content properties (e.g. `confluence-create-footer-comment`, `confluence-create-inline-comment`) |
| **Confluence spaces & attachments** | Read spaces and manage attachments (e.g. `confluence-list-spaces`, `confluence-list-attachments`) |
| **Account & sites** | Read the connected user and accessible Atlassian sites (e.g. `get-account`, `get-accessible-resources`) |

## Edit Integration

Editing not supported. Delete and recreate.

## Delete Integration

Deleting removes the integration and immediately revokes access to Atlassian.

:::warning
Deleting the integration will remove access to Atlassian immediately. Check Atlassian documentation for any cleanup steps regarding issues, pages, or repositories created by Suger.
:::