Team
Shared credential for production and unattended runs.
Connect Jira with Hookshot™ and your stack
A tool for bug tracking, issue tracking, and agile project management.
Tools and triggers
What Agents can do in Jira
Available tools and events after Jira is connected.
-
Add Attachment
This action allows users to upload a file and attach it to a specific Jira issue. It supports various file formats and ensures that the attachment is associated with the correct issue key.
-
Add Comment
This action adds a rich comment to a specific Jira issue, allowing Markdown formatting. Users can specify visibility restrictions for the comment if needed.
-
Add User to Group
This action adds a user to a Jira group. The user is identified by their Atlassian account ID, and the group is identified by either its name or ID.
-
Add Users to Project Role
This action adds one or more users (and optionally groups) to a specific project role in Jira. Users are identified by their Atlassian account IDs, and roles are identified by their role ID.
-
Add Watcher to Issue
This action adds a specified user as a watcher to a Jira issue. A watcher receives notifications about updates to the issue.
-
Add Worklog
Add a worklog entry to a Jira issue to track time spent. You can specify the time worked, when it started, an optional comment, and visibility restrictions.
-
Analyse Jira Expression
Analyses Jira expressions for syntax validation, type checking, and complexity analysis. Use when you need to validate Jira expression syntax before using it in automation rules, custom fields, or workflows.
-
Assign Issue
This action assigns a specified Jira issue to the designated user or the project's default assignee. It also allows for unassigning the issue by not providing an account ID and supports lookup by username or email.
-
Bulk Create Issues
This action creates multiple Jira issues in a single API call. It allows for bulk creation of issues with various attributes, such as assignee and priority, streamlining the issue management process.
-
Bulk Fetch Issues
Tool to bulk fetch multiple Jira issues by their IDs or keys (max 100 per call). Use when you need to retrieve details for multiple issues efficiently in a single API call.
-
Check User Permissions
Check user permissions for global and project-level operations in Jira. Use this action to verify whether a user has specific permissions at the system level or within projects. Useful for authorization checks before…
-
Create Board
Creates a new Jira board (kanban, scrum, or agility) with optional filter and location configuration. Use this action when you need to set up a new board for a project or create a personal board for tracking work. The…
-
Create Group
This action creates a new group in Jira. Groups are used to organize users and manage permissions across projects and issues.
-
Create Issue
Creates a new issue in a specified Jira project. This includes setting parameters such as the issue type, summary, and assignee details. Note: Some projects may have custom required fields - use…
-
Create Project
This action creates a new Jira project with the necessary configurations. It requires information such as the project key, name, type, and template to successfully set up a project in Jira.
-
Create Sprint
This action allows the creation of a new sprint within a specified Jira board. Users can set optional start and end dates, as well as define a primary goal for the sprint.
-
Create Version
This action creates a new version within a specified Jira project, allowing users to manage project milestones effectively. It includes attributes such as name, description, and release dates that provide context to…
-
Delete Attachment
This action permanently deletes a specified attachment from Jira. It requires the attachment ID to perform the delete operation.
-
Delete Comment
This action deletes a specified comment from a Jira issue. It requires the issue ID or key along with the comment ID to perform the delete operation.
-
Delete Issue
This action deletes a specified Jira issue. It can also delete any associated subtasks if requested.
-
Delete Version
This action deletes a specified version in Jira. It can also optionally move issues associated with the deleted version to another specified version.
-
Delete Worklog
This action deletes a specific worklog entry from a Jira issue. It provides options to notify users and adjust the issue's remaining estimate as needed.
-
Edit Issue
Updates a specified Jira issue by changing its fields or adding new information. This action allows users to modify attributes such as the summary, description, and assignee of the issue.
-
Evaluate Jira Expression
Tool to evaluate Jira expressions using the enhanced search API. Use when you need to extract or transform data from Jira using Jira expression language. Useful for complex data queries, transformations, and building…
-
Find Users 2
Tool to find users in Jira by query string, account ID, or property search. Use when you need to search for users to assign to issues, add as watchers, or perform other user-related operations.
-
Find Users for Picker
Find users for picker components by matching query against user attributes like display name and email.
-
Get All Groups
This action retrieves a single page of groups from the Jira instance. Use `start_at` and `max_results` to page through results; the response includes `has_next_page` and `next_start_at` to drive pagination.
-
Get All Issue Type Schemes
This action retrieves a list of all issue type schemes from Jira. It allows for optional filtering based on specific IDs and supports pagination for large sets of data.
-
Get All Projects
Retrieves a list of all projects that the user has visibility over. This action allows filtering, sorting, and pagination of project results based on specified criteria.
-
Get All Users
This action retrieves a single page of users from the Jira instance. Use `start_at` and `max_results` to page through results; the response includes `has_next_page` and `next_start_at` to drive pagination.
-
Get Attachment
Retrieves the binary content of a Jira attachment by ID. Use when you need to download a specific file attached to an issue.
-
Get Attachment Meta
Tool to retrieve Jira attachment settings including upload limits and enabled status. Use when you need to check if attachments are enabled or determine the maximum file size allowed.
-
Get Avatar Image
Tool to retrieve a specific avatar image by type and ID from Jira. Use when you need to download avatar images for projects, issue types, or priorities.
-
Get Comment
This action fetches a specific comment from a Jira issue by its ID. You can specify optional parameters to expand additional information in the response.
-
Get Component
Tool to retrieve components from Jira projects with search and filtering. Use when you need to list or find components across projects, optionally filtered by project IDs/keys or search query.
-
Get Create Field Metadata for Issue Type
Tool to retrieve field metadata for a specific issue type in a project. Use this to discover required fields, allowed values, and field configurations before creating issues of a specific type.
-
Get Current User
This action retrieves detailed information about the currently authenticated Jira user. It provides data such as the user's display name, email address, groups, and application roles.
-
Get Custom Fields Paginated
Tool to retrieve Jira fields in pages. Use when you need to filter or page through custom and system fields.
-
Get Dashboards
Tool to list and search Jira dashboards visible to the current user. Use when you need to discover available dashboards, filter by ownership or favorites, or retrieve dashboard details including permissions and…
-
Get Favorite Filters
Tool to retrieve favorite filters for the current user. Use when you need to discover which saved filters the user has marked as favorites.
-
Get Fields
Retrieves metadata for Jira issue fields so you can identify custom field IDs before editing an issue.
-
Get Filter
This action retrieves a specific Jira saved filter using its ID. It returns the filter's JQL query, owner, sharing permissions, and other metadata. This enables a workflow pattern: (1) list/search filters, (2) get…
-
Get Group
This action retrieves information about a specific Jira group. You can fetch the group by its name or unique ID, and optionally expand to include the list of users in the group.
-
Get Issue
This action retrieves a specific Jira issue using its ID or key. Users can customize the fields and additional data included in the response to suit their specific needs.
-
Get Issue Edit Meta
Tool to retrieve editable fields for a Jira issue. Use before running an edit action to fetch custom field metadata and required fields.
-
Get Issue Link Types
This action retrieves all issue link types configured in the Jira instance. It provides a comprehensive list of the relationships available for issues in your project.
-
Get Issue Picker
Retrieves issue picker suggestions from Jira for auto-completion when searching for issues.
-
Get Issue Property
This action retrieves a specific property associated with a Jira issue using its ID or key. It allows users to access custom information stored in Jira properties.
-
Get Issue Remote Links
This action retrieves remote issue links associated with a specified Jira issue. You can filter the links by providing an optional global ID for a specific link retrieval.
-
Get Issue Resolutions
This action fetches all issue resolutions available in Jira. It retrieves resolution types such as 'Done' or 'Fixed' that can be applied to issues.
-
Get Issue Statuses
This action retrieves issue statuses that are associated with workflows in Jira. It provides detailed information about each status including name, description, and category. Note: This may not include statuses from…
-
Get Issue Types
Retrieves a list of all available Jira issue types for the user. This action allows access to Jira's issue type details that can be utilized within the application.
-
Get Issue Votes
This action retrieves the voting information associated with a specific Jira issue. It provides details such as the total number of votes and whether the user has voted on that issue.
-
Get Issue Watchers
This action retrieves the list of users watching a specific Jira issue. It allows clients to understand who is interested in updates for that issue.
-
Get JQL Autocomplete Data
Retrieves JQL autocomplete reference data including reserved words, field names, and function names. Use when building JQL query editors or validating JQL syntax.
-
Get JQL Autocomplete Reference Data
Tool to retrieve JQL autocomplete reference data. Use when you need to discover available JQL fields, functions, and reserved words for building queries.
-
Get JQL Autocomplete Suggestions
Tool to get JQL field auto-complete suggestions. Use when building JQL queries to discover valid field values or predicate options.
-
Get My Permissions
Tool to retrieve the user's permissions in Jira. Use when checking what actions the authenticated user can perform in a specific context (project, issue, or comment).
-
Get Permissions
This action retrieves all available permissions in Jira, including both project-level and global permissions. It provides details about each permission such as its ID, key, name, type, and description.
-
Get Permitted Projects
This action retrieves a list of projects where the current user has all the specified permissions. It's useful for determining which projects a user can perform certain actions in.
-
Get Project
This action retrieves detailed information about a specific Jira project using its project ID or key. It returns project metadata including name, key, type, and optional expanded fields.
-
Get Project Roles
This action retrieves all available roles for a specific Jira project. It returns role IDs, names, and descriptions which are needed when adding or removing users from project roles.
-
Get Project Templates
Retrieves available Jira project templates for creating projects. Returns template keys that can be used with the Create Project action. Use this action when you need to discover valid project template keys before…
-
Get Project Type
Retrieves detailed information about a specific Jira project type using its key identifier. Returns metadata including the project type's key, formatted name, description key, icon, and color.
-
Get Project Versions
This action retrieves all versions associated with a specific Jira project. It can include additional properties for each version based on the request parameters.
-
Get Recent Projects
This action retrieves a list of Jira projects that were recently accessed by the authenticated user. Use this to quickly find projects the user has been working with recently.
-
Get Server Info
Retrieves detailed information about the Jira instance, including version, build number, deployment type, server time, and URLs.
-
Get Service Desk Request Type Fields
Retrieves the field metadata for a specific Jira Service Management request type, including required fields and valid values needed to submit a request.
-
Get Service Management Info
Retrieves runtime information for the Jira Service Management instance. Use when you need to check the version, build date, or license status.
-
Get Sprint
Retrieves detailed information about a specific sprint by its ID. Use this action when you need to fetch a single sprint's details directly by ID, such as checking sprint status, dates, goal, or metadata. For finding…
-
Get System Avatars
Tool to retrieve all system avatars for a specific type (issuetype, project, user, or priority). Use when you need to get a list of available default avatars that can be assigned to Jira entities.
-
Get Transitions
This action retrieves the available workflow transitions for a specified Jira issue. It can return details about the transitions, including their IDs and names, as well as whether they are currently available for use.
-
Get Universal Avatar Type Owner
Tool to retrieve all avatars (system and custom) for a specific type and entity in Jira. Use when you need to view available avatar options for projects, issue types, or priorities.
-
Get Universal Avatar View Type
Tool to retrieve the default avatar image for a specific type (project, issuetype, or priority) from Jira. Use when you need to download the default avatar for a type.
-
Get User Groups
Retrieves all groups for a specific Jira user by account ID. Use this action when you need to check group membership for a particular user, verify permissions, or audit user access. Essential for understanding which…
-
Get User Locale Preference
Tool to retrieve the locale preference of the currently authenticated Jira user. Use when you need to know the user's language and regional settings.
-
Get Worklogs
Retrieves the worklog entries for a specified Jira issue. This action provides detailed information on time spent by users on the issue, allowing for effective tracking and reporting of work activity.
-
Link Issues
This action links two Jira issues based on the specified relationship type. It allows users to track dependencies and relationships between issues within their projects.
-
List Boards
Retrieves a list of Jira boards based on specified criteria. Supports pagination via start_at and max_results. The response also includes convenience fields nextStartAt, hasNextPage, and nextPageToken to help iterate…
-
List Comments by IDs
Tool to retrieve multiple comments by their IDs in a single request. Use when you need to fetch specific comments efficiently. Supports up to 1000 comment IDs per request with optional expansion for rendered HTML and…
-
List Groups (Picker)
This action searches and lists groups using Jira's picker endpoint, which is optimized for autocomplete and search scenarios. It allows filtering by name and excluding specific groups.
-
List Issue Comments
This action fetches paginated comments associated with a specific Jira issue. It allows users to retrieve details such as the comment content and the authorship information.
-
List Jira Filters
Tool to search and list Jira saved filters (saved searches) visible to the current user. Use when you need to discover existing filters, find filters by name or owner, or get filter details including JQL queries and…
-
List Project Types
Retrieves a list of all project types available in your Jira instance. Returns details about each project type including keys, formatted names, descriptions, icons, and colors.
-
List Sprints
Retrieves and lists sprints associated with a specified Jira board. Users can filter results based on the state of the sprints, allowing for better management and visibility.
-
Move Issues to Sprint
This action takes multiple issues and moves them to a specified sprint in Jira. It ensures that the issues are successfully added to the targeted sprint based on the provided sprint ID.
-
Parse JQL Queries
Parse and validate JQL queries, returning their abstract syntax tree structure along with any errors or warnings. Use when you need to validate JQL syntax or understand query structure before execution.
-
Remove User From Group
This action removes a user from a Jira group. The user is identified by their Atlassian account ID, and the group is identified by either its name or ID.
-
Remove User From Project Role
This action removes a user or group from a specific project role in Jira. Either a user account ID or group name must be provided.
-
Remove Watcher From Issue
This action allows you to remove a specified user from the watchers list of a given issue. You need to provide the issue identification and the user's account ID for the operation to succeed.
-
Search Approximate Count
Count issues matching a JQL query using approximate count endpoint. Use when you need a fast count of issues without retrieving full issue details. The JQL query must be bounded (include at least one search restriction).
-
Search Dashboards
Tool to search for Jira dashboards with filtering, sorting, and pagination support. Use when you need to find dashboards by name, owner, sharing permissions, or status. Supports filtering by owner account ID, group…
-
Search Issues
This action performs advanced searches for Jira issues using either structured filters or raw JQL queries. It supports various search criteria including project, assignee, status, priority, and date ranges.
-
Search Issues Using JQL (GET)
This action retrieves Jira issues based on a specified JQL query. It allows for pagination as well as selection of specific fields to include in the result.
-
Send Notification for Issue
This action sends a customized email notification related to a specific Jira issue. It includes customizable fields for the subject, message content, and recipients, ensuring tailored communication for issue updates.
-
Transition Issue
This action transitions a specified Jira issue to a different status based on the selected workflow transition. It supports optional comments and assignee information. Note: Only fields configured on the transition…
-
Update Comment
This action updates an existing comment on a Jira issue. Users can modify the comment text and adjust visibility settings as needed.
-
Comment Created
Triggers when a comment is posted on a Jira issue. Can deliver comments on issues the connected account cannot open in Jira itself.
-
Comment Deleted
Triggers when a comment is deleted from a Jira issue. The deleted comment's text still arrives. Can deliver comments on issues the connected account cannot open in Jira itself.
-
Comment Updated
Triggers when an existing comment on a Jira issue is edited. The payload carries the comment as it now reads, not what it said before. Can deliver comments on issues the connected account cannot open in Jira itself.
-
Issue Created
Triggers when an issue is created in Jira, including a sub-task. Can deliver issues the connected account cannot open in Jira itself.
-
Issue Deleted
Triggers when an issue is deleted from Jira. The deleted issue's full field set still arrives, so the filters below apply to it as usual. Can deliver issues the connected account cannot open in Jira itself.
-
Issue Updated
Triggers when a field on an existing issue changes — its status, assignee, or anything else on the issue. One edit can change several fields and arrives as one event; creating a sub-task also updates its parent…
-
Sprint Closed
Triggers when a sprint is completed and moves into the closed state.
-
Sprint Created
Triggers when a sprint is created on a Jira board. Creating a sprint does not start it — watch Sprint Started for that.
-
Sprint Started
Triggers when a sprint moves into the active state.
-
Sprint Updated
Triggers when a sprint's name, goal, dates or state changes. Starting a sprint also fires this when the same call changed another field; closing one does not.
-
Version Created
Triggers when a project version is created in Jira.
-
Version Deleted
Triggers when a project version is deleted outright. A version that disappeared because it was merged into another one fires Version Merged instead.
-
Version Merged
Triggers when a project version is merged into another one, carrying both the version that went away and the one that survived.
-
Version Moved
Triggers when a project version is reordered within its project's release list.
-
Version Released
Triggers when a project version is marked released.
-
Version Unreleased
Triggers when a released project version is put back to unreleased.
-
Version Updated
Triggers when a project version's name, description or dates change. Releasing and un-releasing a version each fire this as well, alongside Version Released and Version Unreleased.
Setup
Connect Jira in Hookshot™
Pick a scope, then confirm what can start a Protege and what it can do.
Trigger Access
What can start a Protege from this app.
Tool Access
What a Protege can do after it starts.
Connection scope
Prefer team for production.
Personal
Tied to one user—only when the workflow needs their account.
Chat
Team-scoped for supported chat surfaces.
Build with us
See Hookshot™ in your stack.
Request early access or book a live walkthrough with the team.
