Jira Reader
Jira Reader connects your flow to your Jira Cloud to read information without changing anything: search issues, get one issue with its details, download an attachment, or look up the projects, users, issue types, priorities, statuses and link types available.
It is useful to prepare reports, to let an AI agent answer questions about how projects are going, or to get the details another component needs, such as a project key or a user’s ID.
When to use it
- Every Monday you want a summary of a project’s open issues.
- An AI agent helps the team and needs to check the status of an issue.
- You want to download an issue’s attachments to process them in the flow.
- You need a user’s account ID to assign them an issue with Jira Issue Handler.
Configuration
You need a Jira API credential with your Jira Cloud address, your Atlassian account email and an API token. See Credentials.
| Field | What it does |
|---|---|
| Credential (required) | The Jira API credential used to access your Jira. |
| Operation (required) | What the component does. See Operations. Default: List Issues. |
| Project Key | The Jira project. Once you pick the credential, the list shows your projects. In List Issues (optional: if you leave it empty, issues from all projects are searched), List Users, List Issue Types, List Priorities and List Statuses. |
| Issue Key | The issue key, for example PROJ-123. In Get Issue, List Attachments and List Watchers. |
| Attachment ID | The ID of the attachment you want to download. You get it with List Attachments. Only in Get Attachment. |
| JQL Filter | A filter in Jira’s search language (JQL) combined with the chosen project, for example status = "In Progress" or priority = High AND status = "To Do". Optional. Only in List Issues. |
| Max Results | The maximum number of issues to return. Default: 50. Only in List Issues. |
| Issue Type | The issue type (Task, Bug…) whose priorities you want to look up. Only in List Priorities. |
Operations
| Operation | What it does |
|---|---|
Get Issue | Returns one issue by its key. |
Get Attachment | Downloads an attachment. |
List Issues | Searches issues with the project and JQL filter you give. |
List Users | Returns the users who can be assigned issues in a project. |
List Projects | Returns all the projects you have access to. |
List Issue Types | Returns a project’s issue types. |
List Priorities | Returns the priorities available in a project. |
List Statuses | Returns the workflow statuses of a project. |
List Attachments | Returns the list of an issue’s attachments. |
List Watchers | Returns the people watching an issue. |
List Link Types | Returns the link types between issues (Blocks, Duplicates…). |
Output
The Jira Response output returns one item per result. In List Issues, each issue carries its project, key, title, description as text, type, priority, status, assignee, parent issue and comments. In Get Attachment you get the downloaded file, which you can connect to a component that reads documents or stores it.
You can connect the result to an agent so it can summarize it or answer with it. The component can also be connected to an Agent as a tool, so the agent decides what to look up. See Tool Mode.
Example
A development team wants a weekly summary of urgent issues.
- Schedule the flow to run every Monday.
- Add Jira Reader with the
List Issuesoperation. - Choose the project in Project Key and write
priority IN (High, Highest) AND resolution = Unresolvedin JQL Filter. - Connect Jira Response to an agent that writes the summary and to an email component that sends it to the team.
Related components
- Jira Issue Handler: create and change issues, comments and attachments.
- Jira Webhook: starts a flow when something happens in Jira.