> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> A Jira app for tracking bugs, issues, and agile work through your connected account.

Use this app when you need to create, update, search, or move Jira work items. It also helps you manage comments, attachments, worklogs, projects, boards, and sprints.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Jira account to use for this step. |
| Action | Yes | The Jira action to perform (for example Get Current User, Create Issue, Edit Issue, Get Issue). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Jira in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get Current User** | Returns the connected Jira user account details. |
| **Create Issue** | Creates a new issue in a Jira project. |
| **Edit Issue** | Updates fields on an existing Jira issue. |
| **Get Issue** | Retrieves a Jira issue by ID or key. |
| **Search Issues** | Searches for Jira issues with filters or JQL. |
| **Transition Issue** | Moves a Jira issue to another workflow status. |
| **List Comments** | Lists comments on a Jira issue. |
| **Add Attachment** | Uploads a file and attaches it to a Jira issue. |
| **Add Worklog** | Adds a worklog entry to a Jira issue. |
| **Link Issues** | Links two Jira issues together. |
| **Get All Projects** | Lists all visible Jira projects. |
| **Get Project** | Retrieves details for a Jira project. |
| **List Boards** | Lists Jira boards visible to the user. |
| **Create Board** | Creates a new Jira board. |
| **List Sprints** | Lists sprints on a Jira board. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Jira response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Jira if you have not already done that.
2. Add a **Jira** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get Current User** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a bug from a form reply

1. Create Issue
2. Add Comment
3. Add Attachment

### Route an issue through workflow

1. Search Issues
2. Get Issue
3. Transition Issue

### Plan sprint work

1. List Boards
2. List Sprints
3. Create Sprint

## Notes

* This step depends on a connected Jira integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Jira tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Jira as an Agent Tool

You can also add Jira as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Jira**. In the tool settings panel, choose the connected account the agent should use. The agent calls Jira actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.