# Jira

A tool for bug tracking, issue tracking, and agile project management.

- **Category:** project management
- **Auth:** OAUTH2, API_KEY
- **Tools:** 62
- **Triggers:** 3
- **Slug:** `JIRA`
- **Version:** 20260217_00

## Frequently Asked Questions

### How do I set up custom OAuth credentials for Jira?

For a step-by-step guide on creating and configuring your own Jira OAuth credentials with Devcaster, see [How to create OAuth credentials for Jira](https://devcaster.dev/auth/jira).

### What is the difference between JQL GET, JQL POST, and Search Issues?

JQL GET and POST target the same search functionality but use different HTTP methods. POST supports complex queries in the request body. Search Issues uses JQL POST under the hood with extra parameters and filters. For consistent results, prefer POST for complex queries. Use the `fields` parameter to request specific fields, or `["*all"]` to request all fields.

---

## Tools

### Add Attachment

**Slug:** `JIRA_ADD_ATTACHMENT`

Uploads and attaches a file to a Jira issue.

### Add Comment

**Slug:** `JIRA_ADD_COMMENT`

Adds a comment using Atlassian Document Format (ADF) for rich text to an existing Jira issue.

### Add Users to Project Role

**Slug:** `JIRA_ADD_USERS_TO_PROJECT_ROLE`

Adds users and optionally groups to a project role.

### Add User to Group

**Slug:** `JIRA_ADD_USER_TO_GROUP`

Adds a user to a Jira group.

### Add Watcher to Issue

**Slug:** `JIRA_ADD_WATCHER_TO_ISSUE`

Adds a user to an issue's watcher list by account ID.

### Assign Issue

**Slug:** `JIRA_ASSIGN_ISSUE`

Assigns a Jira issue to a user, default assignee, or unassigns; supports email/name lookup.

### Bulk Create Issues

**Slug:** `JIRA_BULK_CREATE_ISSUE`

Creates multiple Jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling.

### Create Group

**Slug:** `JIRA_CREATE_GROUP`

Creates a new group in Jira with the specified name.

### Create Issue

**Slug:** `JIRA_CREATE_ISSUE`

Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_FIELDS to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{"customfield_12345": "value"}').

### Link Issues

**Slug:** `JIRA_CREATE_ISSUE_LINK`

Links two Jira issues using a specified link type with optional comment.

### Create Project

**Slug:** `JIRA_CREATE_PROJECT`

Creates a new Jira project with required lead, template, and type configuration.

### Create Sprint

**Slug:** `JIRA_CREATE_SPRINT`

Creates a new sprint on a Jira board with optional start/end dates and goal.

### Create Version

**Slug:** `JIRA_CREATE_VERSION`

Creates a new version for releases or milestones in a Jira project.

### Delete Comment

**Slug:** `JIRA_DELETE_COMMENT`

Deletes a specific comment from a Jira issue using its ID and the issue's ID/key; requires user permission to delete comments on the issue.

### Delete Issue

**Slug:** `JIRA_DELETE_ISSUE`

Deletes a Jira issue by its ID or key.

### Delete Version

**Slug:** `JIRA_DELETE_VERSION`

Deletes a Jira version and optionally reassigns its issues.

### Delete Worklog

**Slug:** `JIRA_DELETE_WORKLOG`

Deletes a worklog from a Jira issue with estimate adjustment options.

### Edit Issue

**Slug:** `JIRA_EDIT_ISSUE`

Updates an existing Jira issue with field values and operations. Supports direct field parameters (summary, description, assignee, priority, etc.) that are merged with the fields parameter. Direct parameters take precedence.

### Find Users

**Slug:** `JIRA_FIND_USERS`

Searches for Jira users by email or display name to find account IDs; essential for assigning issues, adding watchers, and other user-related operations.

### Get All Groups

**Slug:** `JIRA_GET_ALL_GROUPS`

Retrieves all groups from the Jira instance with pagination support.

### Get All Issue Type Schemes

**Slug:** `JIRA_GET_ALL_ISSUE_TYPE_SCHEMES`

Retrieves all Jira issue type schemes with optional filtering and pagination.

### Get all projects

**Slug:** `JIRA_GET_ALL_PROJECTS`

Retrieves all visible projects using the modern paginated Jira API with server-side filtering and pagination support.

### Get Issue Statuses

**Slug:** `JIRA_GET_ALL_STATUSES`

Retrieves issue statuses associated with workflows from Jira.

### Get All Users

**Slug:** `JIRA_GET_ALL_USERS`

Retrieves all users from the Jira instance including active, inactive, and other user states with pagination support.

### Get Attachment

**Slug:** `JIRA_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 Comment

**Slug:** `JIRA_GET_COMMENT`

Retrieves a specific comment by ID from a Jira issue with optional expansions.

### Get Current User

**Slug:** `JIRA_GET_CURRENT_USER`

Retrieves detailed information about the currently authenticated Jira user.

### Get custom fields paginated

**Slug:** `JIRA_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 fields

**Slug:** `JIRA_GET_FIELDS`

Tool to retrieve Jira issue fields metadata. Use before editing an issue to discover custom field IDs and names.

### Get Filter

**Slug:** `JIRA_GET_FILTER`

Retrieves a specific Jira saved filter by ID, including its JQL and sharing metadata, to reuse in subsequent searches. Use when you need to fetch filter details or extract the JQL query to run searches.

### Get Group

**Slug:** `JIRA_GET_GROUP`

Retrieves details of a specific Jira group by name or ID.

### Get Issue

**Slug:** `JIRA_GET_ISSUE`

Retrieves a Jira issue by ID or key with customizable fields and expansions.

### Get Issue Edit Meta

**Slug:** `JIRA_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

**Slug:** `JIRA_GET_ISSUE_LINK_TYPES`

Retrieves all configured issue link types from Jira.

### Get Issue Property

**Slug:** `JIRA_GET_ISSUE_PROPERTY`

Retrieves a custom property from a Jira issue by key.

### Get Issue Resolutions

**Slug:** `JIRA_GET_ISSUE_RESOLUTIONS`

Retrieves all available issue resolution types from Jira.

### Get issue types

**Slug:** `JIRA_GET_ISSUE_TYPES`

Retrieves all Jira issue types available to the user using the modern API v3 endpoint; results vary based on 'Administer Jira' global or 'Browse projects' project permissions.

### Get Issue Type Scheme

**Slug:** `JIRA_GET_ISSUE_TYPE_SCHEME`

Gets a Jira issue type scheme by ID with all associated issue types.

### Get Issue Watchers

**Slug:** `JIRA_GET_ISSUE_WATCHERS`

Retrieves users watching a Jira issue for update notifications.

### Get Issue Worklogs

**Slug:** `JIRA_GET_ISSUE_WORKLOGS`

DEPRECATED: Use 'Get Worklogs' action instead. This action is deprecated because it lacks the expand parameter for worklog properties. Use JIRA_GET_WORKLOG which provides the same functionality plus the ability to expand worklog properties using the 'expand' parameter. Legacy description: Retrieves worklogs for a Jira issue with user permission checks.

### Get Project

**Slug:** `JIRA_GET_PROJECT`

Retrieves details of a Jira project by its ID or key.

### Get Project Roles

**Slug:** `JIRA_GET_PROJECT_ROLES`

Retrieves all available roles for a Jira project.

### Get Project Versions

**Slug:** `JIRA_GET_PROJECT_VERSIONS`

Retrieves all versions for a Jira project with optional expansion.

### Get Issue Remote Links

**Slug:** `JIRA_GET_REMOTE_ISSUE_LINKS`

Retrieves links from a Jira issue to external resources.

### Get Service Desk Request Type Fields

**Slug:** `JIRA_GET_SERVICE_DESK_REQUEST_TYPE_FIELDS`

Tool to retrieve JSM request type field metadata for filling out portal requests. Use when you need to know which fields are required and their valid values.

### Get Transitions

**Slug:** `JIRA_GET_TRANSITIONS`

Retrieves available workflow transitions for a Jira issue.

### Get Issue Votes

**Slug:** `JIRA_GET_VOTES`

Fetches voting details for a Jira issue; requires voting to be enabled in Jira's general settings.

### Get Worklogs

**Slug:** `JIRA_GET_WORKLOG`

Retrieves worklogs for a specified Jira issue.

### List Boards

**Slug:** `JIRA_LIST_BOARDS`

Retrieves paginated Jira boards with filtering and sorting options.

### List Jira Filters

**Slug:** `JIRA_LIST_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 sharing permissions.

### List Issue Comments

**Slug:** `JIRA_LIST_ISSUE_COMMENTS`

Retrieves paginated comments from a Jira issue with optional ordering.

### List Sprints

**Slug:** `JIRA_LIST_SPRINTS`

Retrieves paginated sprints from a Jira board with optional state filtering.

### Move Issues to Sprint

**Slug:** `JIRA_MOVE_ISSUE_TO_SPRINT`

Moves one or more Jira issues to a specified active sprint.

### Remove User from Group

**Slug:** `JIRA_REMOVE_USER_FROM_GROUP`

Removes a user from a Jira group.

### Remove User from Project Role

**Slug:** `JIRA_REMOVE_USER_FROM_PROJECT_ROLE`

Removes a user or group from a project role.

### Remove Watcher from Issue

**Slug:** `JIRA_REMOVE_WATCHER_FROM_ISSUE`

Removes a user from an issue's watcher list by account ID.

### Search Issues Using JQL (GET)

**Slug:** `JIRA_SEARCH_FOR_ISSUES_USING_JQL_GET`

Searches for Jira issues using JQL with pagination and field selection.

### Search Issues Using JQL Enhanced (POST)

**Slug:** `JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST`

Searches for Jira Cloud issues using Enhanced JQL via POST request; supports eventual consistency and token-based pagination. IMPORTANT: This action is for Jira Cloud only and will not work with Jira Server or Data Center instances.

### Search issues

**Slug:** `JIRA_SEARCH_ISSUES`

Advanced Jira issue search supporting structured filters and raw JQL.

### Send Notification for Issue

**Slug:** `JIRA_SEND_NOTIFICATION_FOR_ISSUE`

Sends a customized email notification for a Jira issue.

### Transition Issue

**Slug:** `JIRA_TRANSITION_ISSUE`

Transitions a Jira issue to a different workflow state, with support for transition name lookup and user assignment by email.

### Update Comment

**Slug:** `JIRA_UPDATE_COMMENT`

Updates text content or visibility of an existing Jira comment.


## Triggers

### New Issue

**Slug:** `JIRA_NEW_ISSUE_TRIGGER`

Triggered when a new issue is created in Jira

### New Project

**Slug:** `JIRA_NEW_PROJECT_TRIGGER`

Triggered when a new project is added in Jira

### Updated Issue

**Slug:** `JIRA_UPDATED_ISSUE_TRIGGER`

Triggered when an issue is updated in Jira
