Jira
Jira API integration for issues, projects, boards, and sprints
The Jira integration lets your agents manage issues, search with JQL, work with projects, boards, and sprints.
Prerequisites
You need:
- Jira Cloud ID — Find it by navigating to
https://your-domain.atlassian.net/_edge/tenant_info. - One of the following for authentication:
- Email + API Token (Jira Cloud) — Generate an API token at Atlassian Account → Security → API tokens.
- Personal Access Token (Jira Server/Data Center) — Generate in your Jira profile settings.
- OAuth — For user-level access where each chat user authorizes with their own Jira account.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Jira from the integration list
- Give the config a display name (e.g., "Jira - Engineering")
- Enter your Cloud ID in the configuration parameters
- Choose your authentication method:
- Basic Auth — Enter your Atlassian email and API token
- Personal Access Token — Paste your PAT
- OAuth — Click Connect to start the Jira OAuth flow
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach Jira tools from the tools panel
- The agent uses your integration config for all Jira API calls
- Tools are referenced as
jira.list_issues,jira.create_issue, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
list_issues | Search for Jira issues using JQL | ReadOnly |
get_issue | Get a single Jira issue by key/ID | ReadOnly |
create_issue | Create a new issue in a Jira project | Reversible |
update_issue | Update an existing Jira issue's fields | Reversible |
delete_issue | Delete a Jira issue | Irreversible |
transition_issue | Move an issue to a different status | Reversible |
assign_issue | Assign an issue to a user or unassign | Reversible |
list_issue_comments | Get all comments on a Jira issue | ReadOnly |
add_issue_comment | Add a comment to a Jira issue | Irreversible |
list_projects | List all Jira projects the user has access to | ReadOnly |
get_project | Get details of a specific Jira project | ReadOnly |
search_users | Search for Jira users by query string | ReadOnly |
get_current_user | Get the currently authenticated user | ReadOnly |
list_boards | List all Scrum and Kanban boards | ReadOnly |
list_sprints | List all sprints for a Scrum board | ReadOnly |
get_sprint_issues | Get all issues in a specific sprint | ReadOnly |
list_issue_types | Get available issue types and their statuses | ReadOnly |
list_priorities | Get all available priority levels | ReadOnly |
list_statuses | Get all available workflow statuses | ReadOnly |