> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/sre-ai-agent/data-sources/jira.md).

# Jira

## What the Agent Can Do

* Search issues using JQL — find related bugs, incidents, post-mortems
* Create tickets — auto-create incident tickets during investigation
* Get issue details — description, status, assignee, comments

## Setup Instructions

1. Log into your **Atlassian account**
2. Go to <https://id.atlassian.com/manage-profile/security/api-tokens>
3. Click **Create API token**, label it `Pagerly`
4. Copy the token, your Jira URL, and email

## Required Credentials

| Field         | Description                      | Example                              |
| ------------- | -------------------------------- | ------------------------------------ |
| **Jira URL**  | Your Jira Cloud instance URL     | `https://your-company.atlassian.net` |
| **Email**     | Email for your Atlassian account | `you@company.com`                    |
| **API Token** | Atlassian API token              | `your-api-token`                     |

## Context Prompt Tips

> *"Our incident project key is OPS. Bug tickets use type=Bug. Post-mortems are labeled with post-mortem tag."*

## Docs

* [Jira Cloud REST API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)