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

# Jira Platform

> Create and manage Jira issues from automations.

export const flowWebUrl = "https://app.letsflow.ai";

Flow uses this integration to run Jira Platform actions from automations with the team connection selected during setup. Admins choose which actions that team can use, and automation runs call only those allowed actions through the connection.

<Tabs>
  <Tab title="Flow-managed connection">
    ### Prepare in Jira Platform

    Prepare any Jira Platform access, credential, app approval, or admin permission required for the actions this team will use.

    ### Connect in Flow

    <Steps>
      <Step title="Find the Jira Platform integration">
        1. Open **Integrations**.
        2. Choose **Add connection**.
        3. In **Add connection**, search for **Jira Platform**.
        4. Select the **Jira Platform** card.

        <a className="flow-app-link" href={flowWebUrl}>
          Open Flow

          <svg aria-hidden="true" viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <path d="M7 7h10v10" />

            <path d="M7 17 17 7" />
          </svg>
        </a>
      </Step>

      <Step title="Connect">
        1. Pick the team that will use the connection.
        2. Select the Jira Platform actions that team's automations need.
        3. Complete the provider authorization or credential step.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Permissions and scopes

Flow requests scopes during setup based on the actions allowed on the connection. At runtime, Flow checks action access and granted scopes before calling the provider.

<div className="flow-scope-filter" data-flow-scope-filter>
  <button type="button" className="flow-scope-filter-picker" data-flow-scope-filter-trigger>
    <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
      <path d="M3 6h18" />

      <path d="M7 12h10" />

      <path d="M10 18h4" />
    </svg>

    Filter
  </button>

  <div className="flow-scope-filter-menu" data-flow-scope-filter-menu hidden />

  <span data-flow-scope-filter-chips />

  <button type="button" className="flow-scope-filter-clear" data-flow-scope-filter-clear hidden>Clear</button>
</div>

| Scope | Used by actions |
| - | - |
| `read:jira-work` | Get issue, Search issues with JQL |
| `write:jira-work` | Add issue comment, Assign issue, Create issue, Delete issue, Edit issue, Transition issue |

## Supported actions

| Action | Description | <Tooltip tip="Risk estimates the impact of the action. Low reads provider data, medium changes existing records, and high can grant access, remove data, disable resources, or make broad changes.">Risk</Tooltip> |
| - | - | - |
| Add issue comment | Adds a comment on a Jira issue in Jira Platform using automation-provided input. Use it when the automation needs to add this provider record or request. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Assign issue | Updates or triggers a Jira issue assignee in Jira Platform using automation-provided input. Use it after the automation has selected the target record or command. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Create issue | Creates a Jira issue in Jira Platform using automation-provided input. Use it when the automation needs to add this provider record or request. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Delete issue | Removes a Jira issue in Jira Platform. Use it only after the flow confirms the exact target. | <Badge color="red" size="sm" shape="pill">high</Badge> |
| Edit issue | Updates or triggers fields on a Jira issue in Jira Platform using automation-provided input. Use it after the automation has selected the target record or command. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Get issue | Reads a Jira issue from Jira Platform. Use it to fetch current provider state without modifying data. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Search issues with JQL | Reads Jira issues that match a JQL query from Jira Platform. Use it to fetch current provider state without modifying data. | <Badge color="green" size="sm" shape="pill">low</Badge> |
| Transition issue | Updates or triggers a Jira issue workflow status in Jira Platform using automation-provided input. Use it after the automation has selected the target record or command. | <Badge color="green" size="sm" shape="pill">low</Badge> |


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