Skip to main content

​
Jira Integration

Jira integration enables Annie to access your issue tracker, allowing it to search tickets, retrieve issue details, and correlate incidents with existing bugs, tasks, and historical issues.

​
Setup Guide

The recommended way to connect is Connect with Atlassian (OAuth). One authorization covers both Jira and Confluence. You can still use an email + API token as a fallback.
  1. Go to the Anyshift integrations page
  2. Navigate to the Knowledge Base section
  3. Select Jira
  4. Click Connect with Atlassian
  5. Sign in to Atlassian and approve access for your site
  6. You return to Anyshift with the connected site shown (for example, your company Atlassian domain)
The same connection also enables Confluence. You do not need to authorize twice if you later open the Confluence integration page. To disconnect, use Disconnect on the Jira or Confluence integration page. That removes the shared Atlassian OAuth connection for the project.

​
Option B: Email + API token (fallback)

Use this if your organization prefers API tokens, or if OAuth is unavailable.
  1. Go to the Anyshift integrations page
  2. Navigate to the Knowledge Base section
  3. Select Jira
  4. Under the API token section, click Add
  5. Enter your Jira Domain, Email, and API Token
  6. Click Save

​
Jira Domain

Enter your Atlassian domain (e.g., yourcompany.atlassian.net). This is the URL you use to access Jira Cloud. For example, if you access Jira at https://acme.atlassian.net, enter acme.atlassian.net.

​
Email

Enter the email address associated with your Atlassian account (e.g., user@company.com).

​
API Token

Anyshift supports both scoped and classic Atlassian API tokens. Prefer scoped tokens for least-privilege access. No admin configuration is required. Any Atlassian user can create a token and connect their Jira instance. Scoped API token
  1. Go to Atlassian API Token Management
  2. Click Create API token
  3. Select Scoped token type
  4. Enter a label (e.g., “Anyshift Integration”)
  5. Grant the following scopes:
    • read:jira-work - Read Jira issues and projects
    • read:jira-user - Read user information
    • read:servicedesk-request - Read service desk requests
    • read:me - Read your profile information
    • read:account - Read account information
  6. Click Create
  7. Copy the token and paste it into Anyshift
Classic API token Classic tokens inherit all permissions of the Atlassian account.
  1. Go to Atlassian API Token Management
  2. Click Create API token
  3. Select Classic token type
  4. Enter a label (e.g., “Anyshift Integration”)
  5. Click Create
  6. Copy the token and paste it into Anyshift
For more details, see Atlassian’s API Token documentation. Keep your API token secure and do not share it publicly.

​
Required Permissions

Annie performs read-only operations on your Jira instance. Access follows the Atlassian account you authorize (OAuth) or the account tied to your API token. Your account needs access to:
  • View projects
  • View issues and their details
  • Search issues using JQL
Annie does not create, modify, or delete any issues, comments, or other content in your Jira instance.

​
How It Works

Once connected, Annie can leverage your Jira instance during:
  • Incident Investigation: When analyzing an incident, Annie searches for related issues, bugs, and historical tickets to find relevant context and past resolutions
  • Question Answering: When you ask about specific tickets or projects, Annie retrieves the details directly from Jira
  • Correlation: Annie can correlate alerts and incidents with existing Jira tickets to identify known issues

​
Example Use Cases

  • “Search Jira for authentication issues from the last week”
  • “Get details on ticket INFRA-1234”
  • “Find all high-priority bugs in the Platform project”
  • “What Jira tickets are related to Redis connection issues?”
Annie will search your Jira instance using JQL (Jira Query Language) and cite relevant issues in its responses.

​
JQL Query Examples

Annie can construct JQL queries automatically based on your questions:

​
Supported Features

Annie can access the following Jira data: Issues
  • Search issues using JQL
  • Get full issue details (summary, description, status, priority, assignee, etc.)
  • View available status transitions
Projects
  • List all accessible projects
  • Get project details and metadata
Metadata
  • Get available issue types for a project
  • Get custom field definitions

​
Project Scoping

You can optionally restrict which Jira projects Annie can access by specifying Allowed Projects when configuring credentials. Enter a comma-separated list of Jira project keys (e.g., CSGSRE,SRESD,CTXSRESD). When configured:
  • Searches are automatically scoped to the specified projects
  • Direct issue access is restricted — Annie cannot fetch issues from projects not in the list
  • Project listings only show the allowed projects
Leave the field empty to allow access to all projects the service account can see. This is useful when a service account has broad access but you want Annie to focus on specific projects. For stronger isolation, you can also configure project-level permissions on the Atlassian service account itself.

​
Security

  • OAuth access and refresh tokens, and API tokens, are encrypted at rest using AWS KMS
  • Anyshift only reads from your Jira instance (no write operations)
  • All communication uses HTTPS/TLS encryption
  • Credentials are validated against Atlassian APIs when you connect

​
Troubleshooting

​
OAuth connect fails or returns an error

  1. Consent cancelled: Start again with Connect with Atlassian and approve access.
  2. Wrong Atlassian account: Sign out of Atlassian in the browser, then reconnect with the account that can see your Jira site.
  3. Connection shows error status: Disconnect and reconnect with Atlassian so Anyshift can obtain a fresh grant.

​
”401 Unauthorized” or “Invalid credentials” error (API token)

This is usually caused by one of the following:
  1. Token missing required scopes (scoped tokens only): Ensure your scoped token has the read:jira-work, read:jira-user, read:servicedesk-request, read:me, and read:account scopes.
  2. Email/token mismatch: Verify your email matches your Atlassian account email exactly.
  3. Expired or revoked token: Generate a new API token from your Atlassian account settings.

​
”No issues found” when searching

  • Verify your account has permission to view the projects being searched
  • Check that the JQL query syntax is valid
  • Ensure issues exist matching your search criteria

​
Connection timeout

  • For API token setup, verify your Jira domain is correct (e.g., yourcompany.atlassian.net)
  • Check that your Atlassian instance is accessible
Ready to get started? Configure Jira Integration