Skip to main content
Jira is a project management tool for bug tracking, issue tracking, and agile project planning that lets agents create, update, search, and manage issues, sprints, and projects programmatically.

​
Setup

  1. In Agent Studio, go to Tools → Jira → Connect
  2. Paste your API key from the Jira dashboard
  3. Your Jira instance URL and account email will also be required to authenticate requests

​
Available actions

ActionDescription
JIRA_ADD_ATTACHMENTUploads and attaches a file to a Jira issue.
JIRA_ADD_COMMENTAdds a rich-text comment to an existing Jira issue using Atlassian Document Format.
JIRA_ADD_WATCHER_TO_ISSUEAdds a user to an issue’s watcher list by account ID.
JIRA_ASSIGN_ISSUEAssigns a Jira issue to a user, the default assignee, or unassigns it.
JIRA_BULK_CREATE_ISSUECreates up to 50 Jira issues in a single call with full field support.
JIRA_CREATE_ISSUECreates a new Jira issue such as a bug, task, or story in a specified project.
JIRA_CREATE_ISSUE_LINKLinks two Jira issues together using a specified relationship type with an optional comment.
JIRA_CREATE_PROJECTCreates a new Jira project with a required lead, template, and project type configuration.
JIRA_CREATE_SPRINTCreates a new sprint on a Jira board with optional start and end dates and a goal.
JIRA_CREATE_VERSIONCreates a new version for releases or milestones in a Jira project.
JIRA_DELETE_COMMENTDeletes a specific comment from a Jira issue by comment ID.
JIRA_DELETE_ISSUEDeletes a Jira issue by its ID or key, with optional subtask deletion.
JIRA_DELETE_VERSIONDeletes a Jira version and optionally reassigns its associated issues to another version.
JIRA_DELETE_WORKLOGDeletes a worklog entry from a Jira issue with configurable estimate adjustment.
JIRA_EDIT_ISSUEUpdates fields on an existing Jira issue including summary, description, assignee, priority, and more.
JIRA_FIND_USERSSearches for Jira users by email, display name, or username to retrieve their account IDs.
JIRA_GET_ALL_ISSUE_TYPE_SCHEMESRetrieves all Jira issue type schemes with optional ID filtering and pagination.
JIRA_GET_ALL_PROJECTSRetrieves all visible Jira projects using the paginated API with server-side filtering support.
JIRA_GET_ALL_STATUSESRetrieves all available issue statuses from the Jira instance.
JIRA_GET_ALL_USERSRetrieves all users from the Jira instance including active and inactive accounts with pagination.
JIRA_GET_COMMENTRetrieves a specific comment by ID from a Jira issue with optional content expansions.
JIRA_GET_CURRENT_USERRetrieves detailed profile information about the currently authenticated Jira user.
JIRA_GET_ISSUERetrieves a Jira issue by ID or key with customizable fields and expansion options.
JIRA_GET_ISSUE_LINK_TYPESRetrieves all configured issue link types available in the Jira instance.
JIRA_GET_ISSUE_PROPERTYRetrieves a custom property value from a Jira issue by property key.
JIRA_GET_ISSUE_RESOLUTIONSRetrieves all available issue resolution types from Jira.
JIRA_GET_ISSUE_TYPESRetrieves all Jira issue types available to the authenticated user.
JIRA_GET_ISSUE_TYPE_SCHEMERetrieves a Jira issue type scheme by ID along with all its associated issue types.
JIRA_GET_ISSUE_WATCHERSRetrieves the list of users watching a Jira issue for update notifications.
JIRA_GET_ISSUE_WORKLOGSRetrieves worklogs for a Jira issue with optional time-range filtering and pagination.
JIRA_GET_PROJECT_VERSIONSRetrieves all versions defined for a Jira project with optional expansion.
JIRA_GET_REMOTE_ISSUE_LINKSRetrieves links from a Jira issue to external resources, with optional filtering by global ID.
JIRA_GET_TRANSITIONSRetrieves the available workflow transitions for a Jira issue.
JIRA_GET_VOTESFetches voting details for a Jira issue, including the vote count and voters.
JIRA_GET_WORKLOGRetrieves worklog entries for a specified Jira issue with optional pagination and date filters.
JIRA_LIST_BOARDSRetrieves paginated Jira boards with optional filtering by name, type, or project.
JIRA_LIST_ISSUE_COMMENTSRetrieves paginated comments from a Jira issue with optional ordering and rendering.
JIRA_LIST_SPRINTSRetrieves paginated sprints from a Jira board with optional state filtering.
JIRA_MOVE_ISSUE_TO_SPRINTMoves one or more Jira issues into a specified active sprint.
JIRA_REMOVE_WATCHER_FROM_ISSUERemoves a user from an issue’s watcher list by account ID.
JIRA_SEARCH_FOR_ISSUES_USING_JQL_GETSearches for Jira issues using a JQL query via GET request with pagination and field selection.
JIRA_SEARCH_FOR_ISSUES_USING_JQL_POSTSearches for Jira issues using a JQL query via POST request, ideal for long or complex queries.
JIRA_SEARCH_ISSUESAdvanced issue search supporting structured filters such as assignee, status, and priority alongside raw JQL.
JIRA_SEND_NOTIFICATION_FOR_ISSUESends a customized email notification for a Jira issue to specified users, groups, or roles.
JIRA_TRANSITION_ISSUETransitions a Jira issue to a different workflow state with support for comment and assignee updates.
JIRA_UPDATE_COMMENTUpdates the text content or visibility settings of an existing comment on a Jira issue.

​
Adding to an agent

  1. Open your agent in Agent Studio → Agent Builder
  2. Go to Tools and enable Jira
  3. Select only the actions your agent needs
  4. Set auth mode: Shared (agent acts on one account) or Per-user (each end-user connects their own account)

​
Example use cases

Automated bug triage from user reports When a user submits a support request, the agent creates a Jira bug issue using JIRA_CREATE_ISSUE, assigns it to the relevant team member via JIRA_ASSIGN_ISSUE, and adds a comment with reproduction steps using JIRA_ADD_COMMENT. Sprint planning assistant The agent uses JIRA_SEARCH_ISSUES to find all open high-priority issues in a project, then calls JIRA_MOVE_ISSUE_TO_SPRINT to populate an upcoming sprint and JIRA_CREATE_SPRINT to set up the sprint with goals and dates. Release readiness reporter The agent queries issues tied to an upcoming version using JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST, checks their statuses, and sends a summary notification to stakeholders using JIRA_SEND_NOTIFICATION_FOR_ISSUE to surface any blockers before release.