> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlassian

> Connect to Jira and Confluence with API token authentication

Noxus integrates with Atlassian products (Jira and Confluence) using API token authentication for secure, organization-wide access.

## Supported Atlassian Services

| Service        | Authentication | Key Capabilities                                       |
| :------------- | :------------- | :----------------------------------------------------- |
| **Jira**       | API Token      | Create/update issues, manage projects, track workflows |
| **Confluence** | API Token      | Create/edit pages, manage spaces, search content       |

***

## Authentication: API Token

### Description

Atlassian integrations use API tokens for authentication. An API token is a secure credential that allows Noxus to access your Atlassian resources without storing your password.

### When to Use

<CardGroup cols={2}>
  <Card title="Ideal For" icon="circle-check">
    * Automated issue management
    * Documentation workflows
    * Project tracking automation
    * Team collaboration flows
  </Card>

  <Card title="Characteristics" icon="info">
    * **Permission Type**: User-level API token
    * **Setup**: Generate token in Atlassian account
    * **Access Scope**: Based on user's permissions
    * **Best For**: Automation and integrations
  </Card>
</CardGroup>

### Authentication Flow

```mermaid theme={null}
sequenceDiagram
    participant U as User/Admin
    participant A as Atlassian Account
    participant N as Noxus
    participant AJ as Atlassian API

    Note over U,AJ: One-Time Setup
    U->>A: Generate API token
    A->>U: Provide token
    U->>N: Enter credentials
    N->>N: Store token securely

    Note over U,AJ: When running a flow...
    N->>AJ: API request with token
    AJ->>N: Return data
```

***

## Setup Process

<Tabs>
  <Tab title="Generate API Token">
    <Steps>
      <Step title="Go to Atlassian Account">
        Navigate to [id.atlassian.com](https://id.atlassian.com)
      </Step>

      <Step title="Access Security">
        Go to **Security** → **API tokens**
      </Step>

      <Step title="Create Token">
        Click **Create API token**
      </Step>

      <Step title="Name Your Token">
        Enter a label (e.g., "Noxus Integration")
      </Step>

      <Step title="Copy Token">
        Copy the token value immediately (it won't be shown again)
      </Step>
    </Steps>

    <Warning>
      Store the API token securely. You won't be able to retrieve it after leaving the page.
    </Warning>
  </Tab>

  <Tab title="Configure in Noxus">
    <Steps>
      <Step title="Navigate to Integrations">
        Go to Integrations in your Noxus workspace
      </Step>

      <Step title="Select Service">
        Choose Jira or Confluence
      </Step>

      <Step title="Enter Credentials">
        Provide:

        * **Email**: Your Atlassian account email
        * **API Token**: The token you generated
        * **Site URL**: Your Atlassian site URL (e.g., `yourcompany.atlassian.net`)
      </Step>

      <Step title="Test Connection">
        Click **Test** to verify the connection
      </Step>

      <Step title="Save">
        Click **Save** to complete the setup
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Jira Integration

### Capabilities

<AccordionGroup>
  <Accordion title="Issue Management" icon="circle-dot">
    **Create and Update Issues:**

    * Create new issues with custom fields
    * Update issue status and assignees
    * Add comments and attachments
    * Link related issues
    * Set priority and labels

    **Search and Query:**

    * Search issues with JQL
    * Filter by project, status, assignee
    * Get issue details and history
    * Track issue changes
  </Accordion>

  <Accordion title="Project Operations" icon="folder">
    **Project Management:**

    * List all accessible projects
    * Get project details and configuration
    * Access project boards
    * Manage project components
    * View project workflows
  </Accordion>

  <Accordion title="Workflow Automation" icon="git-branch">
    **Automated Workflows:**

    * Transition issues between statuses
    * Assign issues based on criteria
    * Create sub-tasks automatically
    * Update custom fields
    * Sync with external systems
  </Accordion>
</AccordionGroup>

### Common Use Cases

<Tabs>
  <Tab title="Automated Issue Creation">
    **Create Jira issues from various sources:**

    ```mermaid theme={null}
    graph LR
        A[Customer Email] --> B[Extract Info]
        B --> C[Create Jira Issue]
        C --> D[Notify Team]
    ```

    * Support requests → Jira tickets
    * Bug reports from forms
    * Feature requests from Slack
    * Automated task creation
  </Tab>

  <Tab title="Status Sync">
    **Keep Jira in sync with other systems:**

    ```mermaid theme={null}
    graph LR
        A[External System] --> B[Check Status]
        B --> C[Update Jira]
        C --> D[Notify Stakeholders]
    ```

    * Sync with GitHub issues
    * Update from CI/CD pipelines
    * Reflect changes from other tools
  </Tab>

  <Tab title="Reporting">
    **Generate automated reports:**

    ```mermaid theme={null}
    graph LR
        A[Schedule] --> B[Query Jira]
        B --> C[Generate Report]
        C --> D[Distribute]
    ```

    * Sprint summaries
    * Issue statistics
    * Team performance metrics
    * SLA tracking
  </Tab>
</Tabs>

***

## Confluence Integration

### Capabilities

<AccordionGroup>
  <Accordion title="Page Management" icon="file-text">
    **Create and Edit Pages:**

    * Create pages in any space
    * Update page content
    * Add labels and metadata
    * Manage page hierarchy
    * Version tracking

    **Content Operations:**

    * Read page content
    * Export to different formats
    * Search across spaces
    * Attach files
  </Accordion>

  <Accordion title="Space Operations" icon="layers">
    **Space Management:**

    * List accessible spaces
    * Get space details
    * Create new spaces (if permissions allow)
    * Manage space permissions
    * Access space content
  </Accordion>

  <Accordion title="Search and Discovery" icon="search">
    **Content Search:**

    * Search across all spaces
    * Filter by space, label, or content type
    * Full-text search
    * Recently updated content
    * Access page metadata
  </Accordion>
</AccordionGroup>

### Common Use Cases

<Tabs>
  <Tab title="Documentation Generation">
    **Automatically create documentation:**

    ```mermaid theme={null}
    graph LR
        A[Data Source] --> B[Generate Content]
        B --> C[Create Confluence Page]
        C --> D[Notify Team]
    ```

    * API documentation from specs
    * Meeting notes from transcripts
    * Status reports
    * Knowledge base articles
  </Tab>

  <Tab title="Knowledge Sync">
    **Sync content between systems:**

    ```mermaid theme={null}
    graph LR
        A[External Source] --> B[Transform Content]
        B --> C[Update Confluence]
        C --> D[Index for Search]
    ```

    * Import documentation
    * Update from GitHub wikis
    * Sync with knowledge bases
  </Tab>

  <Tab title="Content Search">
    **Search Confluence from flows:**

    ```mermaid theme={null}
    graph LR
        A[User Query] --> B[Search Confluence]
        B --> C[Return Results]
        C --> D[Present to User]
    ```

    * Find relevant documentation
    * Answer questions from pages
    * Extract information
    * Build internal search tools
  </Tab>
</Tabs>

***

## Security Best Practices

<CardGroup cols={2}>
  <Card title="API Token Management" icon="key">
    * Rotate tokens regularly (every 90-180 days)
    * Use separate tokens for different integrations
    * Revoke unused tokens
    * Monitor token usage
  </Card>

  <Card title="Access Control" icon="shield">
    * Use accounts with appropriate permissions
    * Don't use admin accounts unless necessary
    * Review Jira/Confluence permissions
    * Audit automation activities
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Failed" icon="circle-x">
    **Possible Causes:**

    * Invalid API token
    * Token expired or revoked
    * Incorrect email address
    * Wrong site URL

    **Solutions:**

    * Generate a new API token
    * Verify email matches token owner
    * Check site URL format (e.g., `company.atlassian.net`)
    * Test connection with Atlassian API directly
  </Accordion>

  <Accordion title="Permission Denied" icon="shield-x">
    **Possible Causes:**

    * Insufficient Jira/Confluence permissions
    * Project/space access restrictions
    * Issue type not allowed
    * Field restrictions

    **Solutions:**

    * Verify user has required permissions
    * Check project/space access settings
    * Review issue type scheme
    * Confirm field permissions
  </Accordion>

  <Accordion title="Rate Limit Exceeded" icon="gauge">
    **Possible Causes:**

    * Too many API requests
    * Concurrent flow executions
    * Bulk operations

    **Solutions:**

    * Implement delays between requests
    * Use batch operations where available
    * Reduce flow execution frequency
    * Contact Atlassian about rate limits
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Developer Tools" icon="code" href="/integrations/providers/developer-tools">
    GitHub, Linear, and more
  </Card>

  <Card title="Collaboration" icon="message-circle" href="/integrations/providers/collaboration">
    Slack, Notion, and team tools
  </Card>

  <Card title="All Integrations" icon="blocks" href="/integrations/catalog">
    Browse the complete catalog
  </Card>
</CardGroup>