> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-apis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Using the JIRA Action Templates

<Badge icon="arrow-left" color="gray">[Back to Actions Integrations](/ai-for-service/integrations/overview#actions)</Badge>

Use prebuilt JIRA action templates to auto-create dialog tasks for managing issues.

**To access templates:**

1. Go to **Automation AI** > **Use Cases** > **Dialogs** and click **Create a Dialog Task**.

2. Under **Integration**, select **JIRA**.

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-action-img14-tem-img2.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=80aa77e13113818227f5801df201e197" alt="Integration - JIRA" width="796" height="908" data-path="ai-for-service/integrations/actions/images/jira-action-img14-tem-img2.png" />

3. If no integration is configured, click **Explore Integrations** to set one up. See [Actions Overview](/ai-for-service/integrations/overview#actions).

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img3.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=2c17683bfe95e2bd038bc6e6e7ba69af" alt="Explore Integrations" width="892" height="906" data-path="ai-for-service/integrations/actions/images/jira-tem-img3.png" />

***

## Supported Actions

| Task               | Description                  | Method |
| ------------------ | ---------------------------- | ------ |
| Create an Issue    | Creates an issue in JIRA.    | POST   |
| Get an Issue by ID | Fetches issue details by ID. | GET    |
| Get all issues     | Retrieves all issues.        | GET    |
| Update an Issue    | Updates an issue.            | PUT    |
| Delete an issue    | Deletes an issue.            | GET    |

***

### Create an Issue

1. Install the template from [JIRA Action Templates](/ai-for-service/integrations/actions/configuring-the-jira-action#step-2-install-the-jira-action-templates).

2. The **Create an issue** dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img4.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=61d93c1b114eb755700abf223d911e2e" alt="Create an issue dialog task is added" width="1725" height="911" data-path="ai-for-service/integrations/actions/images/jira-tem-img4.png" />

   * **createIssue** - User intent to create an issue.

   * **projectKey**, **summary**, **issueTypeName** - Entity nodes for issue details.

   * **getResourceIdService** - Bot action service to get JIRA site resource ID.

   * **createIssueService** - Bot action service to create an issue. Click **Edit Request**:

     <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img5.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=43d3350dc0010125e85276238d6ef95b" alt="Edit Request" width="1913" height="841" data-path="ai-for-service/integrations/actions/images/jira-tem-img5.png" />

     **Sample Request:**

     ```json theme={null}
     {
       "fields": {
         "summary": "messaging module isn't working",
         "issuetype": {"name": "Bug"},
         "project": {"key": "DFJIIP"}
       }
     }
     ```

     **Sample Response:**

     ```json theme={null}
     {
       "id": "10000",
       "key": "ED-24",
       "self": "https://your-domain.atlassian.net/rest/api/3/issue/10000"
     }
     ```

   * **createdIssueInfoService** - Bot action service for additional issue details.

   * **createIssueMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img6.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=8bf44c438383173422bc4fb278b425db" alt="VA prompt to create issue" width="491" height="862" data-path="ai-for-service/integrations/actions/images/jira-tem-img6.png" />

***

### Get an Issue by Key

1. Install the template from [JIRA Action Templates](/ai-for-service/integrations/actions/configuring-the-jira-action#step-2-install-the-jira-action-templates).

2. The **Get Issues by Key** dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img7.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=18624f53877e10e59538b0c8997fa090" alt="Get Issues by Key dialog task is added" width="1691" height="881" data-path="ai-for-service/integrations/actions/images/jira-tem-img7.png" />

   * **getIssuebyKey** - User intent to find an issue by key.

   * **issueKey** - Entity node for the issue key.

   * **getResourceIdService** - Bot action service to get JIRA site resource ID.

   * **getIssuebyKeyService** - Bot action service to find an issue. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img8.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=fe8bfc2fa541c883e79a76cd3faae6f6" alt="Add response" width="1914" height="851" data-path="ai-for-service/integrations/actions/images/jira-tem-img8.png" />

     **Sample Response:** (truncated)

     ```json theme={null}
     {
       "id": "10002",
       "timetracking": {
         "originalEstimate": "10m",
         "remainingEstimate": "3m",
         "timeSpent": "6m"
       }
     }
     ```

   * **getIssuebyKeyMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img9.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=43f3df7fb2512a442c5e78a9a7742364" alt="VA prompt to find issue by key" width="499" height="850" data-path="ai-for-service/integrations/actions/images/jira-tem-img9.png" />

***

### Get All Issues

1. Install the template from [JIRA Action Templates](/ai-for-service/integrations/actions/configuring-the-jira-action#step-2-install-the-jira-action-templates).

2. The **Get All Issues** dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img10.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=85fa78214ce2c5b32a3cd0f90d1ccfa5" alt="Get All Issues dialog task is added" width="1722" height="913" data-path="ai-for-service/integrations/actions/images/jira-tem-img10.png" />

   * **getAllIssues** - User intent to view all issues.

   * **getResourceIdService** - Bot action service to get JIRA site resource ID.

   * **getAllIssuesService** - Bot action service to fetch all issues. Click **+Add Response**:

     <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img11.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=a671199b7abf9298aa004651b3da0c39" alt="Add response" width="1919" height="853" data-path="ai-for-service/integrations/actions/images/jira-tem-img11.png" />

     **Sample Response:** (truncated)

     ```json theme={null}
     {
       "expand": "names,schema",
       "startAt": 0,
       "maxResults": 50,
       "total": 1,
       "issues": [
         {
           "id": "10002",
           "key": "ED-1"
         }
       ]
     }
     ```

   * **getAllIssuesMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img12.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=a41150bbb7a6a2448e3f05585ea8b43a" alt="VA prompt to view all issues" width="497" height="856" data-path="ai-for-service/integrations/actions/images/jira-tem-img12.png" />

***

### Update an Issue

1. Install the template from [JIRA Action Templates](/ai-for-service/integrations/actions/configuring-the-jira-action#step-2-install-the-jira-action-templates).

2. The **Update an Issue** dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img13.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=6069e7798b70fc1ed7eb439d722d76e7" alt="Update an Issue dialog task is added" width="1724" height="902" data-path="ai-for-service/integrations/actions/images/jira-tem-img13.png" />

   * **updateIssue** - User intent to update an issue.

   * **issueKey**, **chooseField**, **updatedSummary**, **newLabel** - Entity nodes for update details.

   * **prepareUpdateIssuePayloadScript** - Bot action script to prepare update payload:

     <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img14.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=5e8d5cb0863c497740b303169b185549" alt="prepareUpdateIssuePayloadScript" width="1916" height="802" data-path="ai-for-service/integrations/actions/images/jira-tem-img14.png" />

   * **getResourceIdService** - Bot action service to get JIRA site resource ID.

   * **updateIssueService** - Bot action service to update an issue. Click **Edit Request**:

     <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img15.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=0c1198f5d42e9f5b55eccc1e3f8573d8" alt="Edit Request" width="1919" height="858" data-path="ai-for-service/integrations/actions/images/jira-tem-img15.png" />

     **Sample Request:**

     ```json theme={null}
     {
       "update": {
         "summary": [{"set": "The updated summary"}],
         "labels": {"add": "Label_to_add_without_space"}
       }
     }
     ```

   * **getIssuebyKeyService** - Bot action service for issue details.

   * **updateIssueMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** to test:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img16.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=8111759cf85290cc56d2e7837be9b1ec" alt="VA prompt to update an issue" width="488" height="850" data-path="ai-for-service/integrations/actions/images/jira-tem-img16.png" />

***

### Delete an Issue

<Note>You can delete an issue only if the JIRA admin or project owner grants you delete permission.</Note>

1. Install the template from [JIRA Action Templates](/ai-for-service/integrations/actions/configuring-the-jira-action#step-2-install-the-jira-action-templates).

2. The **Delete an Issue** dialog task is added with the following components:

   <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img17.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=d7b9cacde8f0a68ab121864d39b876b9" alt="Delete an Issue dialog task is added" width="1731" height="910" data-path="ai-for-service/integrations/actions/images/jira-tem-img17.png" />

   * **deleteIssue** - User intent to delete an issue.

   * **issueKey** - Entity node for the issue key.

   * **getResourceIdService** - Bot action service to get JIRA site resource ID.

   * **deleteIssueService** - Bot action service to delete an issue. Click **Edit Request**:

     <img src="https://mintcdn.com/koreai-apis/bBDuuBlq9aqBrVtk/ai-for-service/integrations/actions/images/jira-tem-img18.png?fit=max&auto=format&n=bBDuuBlq9aqBrVtk&q=85&s=a810d2b43ef67dadfb4d58218db40ec7" alt="Edit request" width="1919" height="847" data-path="ai-for-service/integrations/actions/images/jira-tem-img18.png" />

   * **deleteIssueMessage** - Message node to display responses.

3. Click **Train**, then **Talk to Bot** and follow prompts to delete an issue.
