aura.
Integrations

Atlassian (Jira) Integration

Connect Jira and Confluence to aura for project management automation

Atlassian Integration

Revolutionize your project management with aura's Atlassian integration. Connect Jira and Confluence to bring your projects and documentation into a unified workflow.

What You Can Do

Jira Integration

  • Advanced Search: Use natural language to search for issues and projects - aura converts it to JQL for you
  • Issue Management: Create, update, and transition issues without leaving aura
  • Collaboration: Add comments to issues and keep your team in the loop
  • Smart Queries: Ask questions like "Show me all high-priority bugs assigned to me"

Confluence Integration (Coming Soon)

Soon, you'll be able to search, read, and create Confluence pages directly from aura, bringing your knowledge base and project management closer together.

Prerequisites

Before connecting Atlassian to aura, you'll need:

  1. Atlassian Account: An active Atlassian Cloud account
  2. API Token: Generated from your Atlassian account settings
  3. Cloud ID: Your Atlassian Cloud Site's unique identifier
  4. User Name: Your Atlassian account email address
  5. Permissions: Access to the Jira projects you want to search

Connection Setup

Step 1: Generate an API Token

  1. Go to Atlassian API Tokens
  2. Click "Create API token"
  3. Enter a label for the token (e.g., "aura Integration")
  4. Important: Set the expiry date to at least 1 year in the future
  5. Click "Create"
  6. Copy the generated token immediately (you won't be able to see it again)

Step 2: Find Your Cloud ID

Your Cloud ID is a unique identifier for your Atlassian Cloud site.

How to find it:

  1. Visit Atlassian Support - Retrieve Cloud ID
  2. Follow the instructions to locate your Cloud ID
  3. Copy the Cloud ID for use in aura

Alternative method:

  1. Go to any Jira page in your workspace
  2. Look at the URL: https://your-domain.atlassian.net/...
  3. Your Cloud ID can be found through the Atlassian API or admin settings

Step 3: Identify Your Username

Your Atlassian username is the email address you use to log in to Atlassian.

Example: john.doe@company.com

Step 4: Connect in aura

  1. Navigate to the Integrations page in aura
  2. Find "Atlassian" and click "Connect & Configure"
  3. You'll see two tabs: "Info" and "Settings"
  4. Click on the "Settings" tab
  5. Enter your information:
    • API Token: Paste the token you generated
    • Cloud ID: Enter your Atlassian Cloud Site's Cloud ID
    • User Name: Enter your Atlassian email address
  6. Click "Connect Atlassian"
  7. Wait for the connection to be established
  8. Return to your dashboard to verify the status shows "Ready"

Understanding Connection Status

✅ Connected (Ready)

Your Atlassian integration is working properly. You can:

  • Search for Jira issues
  • Create and update issues
  • Add comments to issues
  • View project information

⚠️ Not Connected

The integration hasn't been set up yet. Follow the connection setup steps above.

⚠️ Token Expired

Your API token has expired and needs to be updated:

  1. Generate a new API token following Step 1 above
  2. Go to the Atlassian integration page in aura
  3. Click the "Settings" tab
  4. Enter the new API token
  5. Update your Cloud ID and Username if needed
  6. Click "Update Atlassian"

Using the Atlassian Integration

Searching for Issues

Use natural language to search for Jira issues:

Examples:

  • "Show me all bugs assigned to me"
  • "Find high-priority issues in the Marketing project"
  • "What are the open tasks for Q4 2024?"
  • "Search for issues created last week"

aura automatically converts your natural language query to JQL (Jira Query Language) and returns relevant results.

Creating Issues

Through aura's chat interface, you can create new Jira issues:

Example: "Create a bug in the DEV project: Login button not working on mobile"

aura will:

  1. Understand your intent
  2. Create the issue in the specified project
  3. Set appropriate fields (type, summary, description)
  4. Confirm the creation with the issue key

Updating Issues

Modify existing issues through natural language commands:

Examples:

  • "Update DEV-123 status to In Progress"
  • "Add comment to PROJ-456: Waiting for design approval"
  • "Change priority of BUG-789 to High"

Viewing Issue Details

Ask aura to show you detailed information about specific issues:

Examples:

  • "Show me details for DEV-123"
  • "What's the status of PROJ-456?"
  • "Who is assigned to BUG-789?"

Updating Your Integration

When to Update

Update your Atlassian integration when:

  • Your API token expires (recommended: update before expiration)
  • You change your Atlassian password
  • You need to connect to a different Atlassian site
  • The integration status shows "Token Expired"

How to Update

  1. Navigate to the Atlassian integration page
  2. Click the "Settings" tab
  3. Generate a new API token if needed
  4. Enter the updated information:
    • New API Token
    • Cloud ID (if changed)
    • Username (if changed)
  5. Click "Update Atlassian"
  6. Verify the status returns to "Ready"

Disconnecting the Integration

To remove the Atlassian integration:

  1. Go to the Atlassian integration page
  2. Click the "Info" tab
  3. Scroll down and click "Unlink Atlassian"
  4. Confirm the disconnection
  5. You'll be redirected to the Integrations page

Note: Disconnecting will:

  • Remove access to Jira data in aura
  • Stop syncing issues
  • Prevent you from creating or updating issues through aura
  • Not affect your Atlassian account or data

Troubleshooting

Connection Failed

Possible causes:

  • Incorrect API token
  • Wrong Cloud ID
  • Invalid username
  • Network connectivity issues

Solutions:

  1. Verify your API token is correct and not expired
  2. Double-check your Cloud ID
  3. Ensure your username is your Atlassian email
  4. Try generating a new API token
  5. Check your internet connection

Search Not Returning Results

Possible causes:

  • No issues match your search criteria
  • Insufficient permissions in Jira
  • Integration not fully synced

Solutions:

  1. Try broader search terms
  2. Verify you have access to the projects in Jira
  3. Check that the integration status is "Ready"
  4. Ensure issues exist in your Jira instance

Cannot Create or Update Issues

Possible causes:

  • Insufficient permissions in Jira
  • Required fields not provided
  • Project doesn't exist
  • Token expired

Solutions:

  1. Verify you have create/edit permissions in Jira
  2. Provide all required information
  3. Check that the project key is correct
  4. Update your API token if expired

Token Keeps Expiring

Solution:

  • When generating API tokens, set expiration to 1 year or longer
  • Set a calendar reminder to update before expiration
  • Consider using a service account with long-lived tokens

Security & Permissions

What aura Can Access

With the Atlassian integration, aura can:

  • Read issues from projects you have access to
  • Create issues in projects where you have create permissions
  • Update issues where you have edit permissions
  • Add comments to issues you can view

What aura Cannot Access

aura respects Jira permissions and cannot:

  • Access projects you don't have permission to view
  • Modify issues you don't have permission to edit
  • Delete issues or projects
  • Change project settings or permissions

Token Security

Your Atlassian API token is:

  • Encrypted in transit and at rest
  • Never exposed in logs or error messages
  • Only used to authenticate with Atlassian APIs
  • Revocable at any time from your Atlassian account

Best Practices

Token Management

  • Set API token expiration to at least 1 year
  • Create calendar reminders before token expiration
  • Use descriptive labels for tokens (e.g., "aura Integration - Expires Dec 2025")
  • Revoke old tokens after creating new ones

Search Efficiency

  • Use specific project keys when possible
  • Include relevant keywords in your queries
  • Leverage natural language - aura handles the JQL conversion
  • Save frequently used searches as templates

Issue Management

  • Provide clear, descriptive summaries when creating issues
  • Include all relevant details in descriptions
  • Use appropriate issue types (Bug, Task, Story, etc.)
  • Keep issue updates concise and actionable

Advanced Features

JQL Support

While aura converts natural language to JQL, you can also use JQL directly:

Example: "project = DEV AND status = 'In Progress' AND assignee = currentUser()"

Bulk Operations

Through aura's chat interface, you can perform bulk operations:

Example: "Update all high-priority bugs in DEV project to status 'In Review'"

Custom Fields

aura supports Jira custom fields:

Example: "Show me issues where Sprint = 'Sprint 23'"

Coming Soon

Confluence Integration

Soon you'll be able to:

  • Search Confluence pages and spaces
  • Create and update pages
  • Link Jira issues to Confluence pages
  • View page content directly in aura

Need Help?

Connect your Atlassian account to aura and transform how you manage projects and collaborate with your team.

Notion Integration

Connect your Notion workspace to aura for seamless knowledge management

Slack Integration

Connect your Slack workspace to aura for team communication and collaboration

On this page

Atlassian IntegrationWhat You Can DoJira IntegrationConfluence Integration (Coming Soon)PrerequisitesConnection SetupStep 1: Generate an API TokenStep 2: Find Your Cloud IDStep 3: Identify Your UsernameStep 4: Connect in auraUnderstanding Connection Status✅ Connected (Ready)⚠️ Not Connected⚠️ Token ExpiredUsing the Atlassian IntegrationSearching for IssuesCreating IssuesUpdating IssuesViewing Issue DetailsUpdating Your IntegrationWhen to UpdateHow to UpdateDisconnecting the IntegrationTroubleshootingConnection FailedSearch Not Returning ResultsCannot Create or Update IssuesToken Keeps ExpiringSecurity & PermissionsWhat aura Can AccessWhat aura Cannot AccessToken SecurityBest PracticesToken ManagementSearch EfficiencyIssue ManagementAdvanced FeaturesJQL SupportBulk OperationsCustom FieldsComing SoonConfluence IntegrationNeed Help?