Definition

The Delete Issue action allows users to permanently remove a specified issue from their Jira project. By providing the necessary connection details, Jira Cloud ID, and the issue key, this action ensures that issues no longer needed or created by mistake can be efficiently deleted. This helps maintain a clean and organised project space while preventing unnecessary clutter in the issue tracking system. It is particularly useful for project administrators or team leads managing workflows.

Example Use Cases

1. Removing Test Issues

During project setup or workflow testing, test issues may be created. Use this action to delete these placeholder issues and keep your Jira project clean.

2. Eliminating Duplicate Issues

If duplicate issues are created accidentally, this action can help remove redundant entries to avoid confusion and streamline task management.

3. Archiving Completed Projects

For projects that have been completed, any remaining irrelevant or old issues can be deleted to free up space and reduce clutter in the project.

4. Deleting Mistakenly Created Issues

If an issue is created with incorrect details or in the wrong project, this action allows you to delete it quickly and create a new one with the correct information.

5. Managing Backlogs

When managing a backlog, issues that are no longer relevant or have been deprioritised indefinitely can be deleted to ensure the backlog remains focused and actionable.

Inputs

1. Connection

This field establishes a connection to your Jira account. It ensures that the action has the necessary authentication and permissions to interact with your Jira instance.

• How to Use: Select or configure your Jira connection by providing the required credentials or tokens.

2. Jira Cloud

The unique identifier for your Jira Cloud instance. This is used to identify and authenticate the specific Jira instance where the issue resides.

• How to Use: Enter the Cloud ID of your Jira instance. You can find this ID in your Jira Administration settings.

3. Issue Key

The unique key of the issue you want to delete. This key is used to identify the specific issue in Jira.

• How to Use: Provide the issue key, which can typically be found in the issue details or retrieved from outputs of previous actions (e.g., "List Issues").

Step-by-Step Guide

Follow these steps to demonstrate the "Delete Issue" action in a flow:

1. Add the "Delete Issue" Action to Your Flow

• Drag and drop the "Delete Issue" action from the "Jira" category into your flow.

2. Configure the Connection

• Select an existing Jira connection or set up a new connection by providing your Jira credentials or access token.
• Ensure the connection has sufficient permissions to delete issues in the specified project.

3. Enter the Jira Cloud ID

• Provide the Cloud ID of your Jira instance.
• Use the settings or administration panel in Jira to locate this ID if you are unsure.

4. Specify the Issue Key

• Enter the unique key of the issue you want to delete.
• Alternatively, if you have a previous step in your flow (e.g., "List Issues"), map the "Issue Key" field from that step to this input.

5. Test the Flow

• Run the flow to ensure the action works as expected.
• If the issue is successfully deleted, you will see confirmation in the flow output.

7. Handle Errors or Exceptions

• If the issue cannot be deleted (e.g., due to insufficient permissions or invalid issue key), review the error message in the flow logs.
• Adjust the inputs or permissions as needed and re-run the flow.

This step-by-step process ensures that the "Delete Issue" action is properly configured and demonstrated within a flow.