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

# Jira

> Create coverage requests from Jira tickets

With our Jira integration, you can create coverage requests from your issue trackers.

## User flow

* In your Jira workspace, create a new ticket or use an existing ticket
  * The title and description are used to create a prompt, and should cover the user scenario that needs to be covered
  * Attachments are also supported: e.g., images in the ticket are also provided to the agent
* Add "empirical" as a label on the ticket
* This creates a [request](https://dash.empirical.run/requests) in Empirical
  * A link to the request is sent as a comment on the Jira ticket
  * Empirical AI agents start working on the request right away
* Once the request is completed, the integration creates

## Routing to projects

If your organization has one project, all Jira tickets are routed to it.

With multiple projects, map each Jira project key to a project under **Settings → Requests → Project associations**. Tickets are then routed by their Jira project.

## Get started

To install the Jira integration:

1. Navigate to the [Integrations](https://dash.empirical.run/settings/integrations) page
2. Click "Connect" on the Jira integration
3. Once you accept the permissions, the integration is configured

## Permissions

The integration requests for the following permissions.

| Scope                     | Purpose                                                                          |
| ------------------------- | -------------------------------------------------------------------------------- |
| Manage jira-webhook       | Create a webhook that receives Jira events when label is added                   |
| View and update jira-work | Get contents of the ticket, fetch attachments, post comments with status updates |
| View jira-user            | Get details of the user who assigned the label                                   |