> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-ai-for-work-dev.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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-action-img14-tem-img2.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=d5236414073ff1a8e7365b5e6a8d887b" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img3.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=f7ce26fd7566b8371c67f827a94285b4" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img4.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=5873bf827fb6e6eb82c2d0f1f5799c26" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img5.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=8dbef5d736a30a46e30eb2bf0ed24c37" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img6.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=a281d0d2f2fce3d735f55b4ff9793d80" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img7.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=8057b4b057dfb589727ee50f11a21e83" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img8.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=53430c030468a080b441512a3619e3aa" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img9.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=794b80ea9f814dc45c543a77eba1881b" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img10.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=d31efc0a34bf7ebbfecf88941a1d9f37" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img11.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=60c095bb8d43c9a737acfeb792c98c52" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img12.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=0352a2b4ef72fbbc959c316af5e3e56c" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img13.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=496c7511be7ede01284d0e10d3f0e08c" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img14.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=8189be33c0cc848120fac5143a4d5c91" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img15.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=ea18abfb8bf30952abed423a820a21f8" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img16.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=20bac4d98c0a02ecc7a1a875c35b247f" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img17.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=c29b4ca8514ba3cdf2f7cc85658d7ddd" 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-ai-for-work-dev/ewPaQ3tSY_EES0i2/ai-for-service/integrations/actions/images/jira-tem-img18.png?fit=max&auto=format&n=ewPaQ3tSY_EES0i2&q=85&s=d049a159861b3024acf38b0076dbae52" 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.
