Delete issue

DELETE

/rest/api/3/issue/{issueIdOrKey}

Deletes an issue.

An issue cannot be deleted if it has one or more subtasks. To delete an issue with subtasks, set deleteSubtasks. This causes the issue's subtasks to be deleted with the issue.

This operation can be accessed anonymously.

Permissions required:

Browse projects and Delete issues project permission for the project containing the issue.

If issue-level security is configured, issue-level security permission to view the issue.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'http://jira.local:8080/jira/rest//rest/api/3/issue/'

Response Example

204 - Example 1

{}

Request

Path Params

issueIdOrKey

string

required

The ID or key of the issue.

Query Params

deleteSubtasks

string

optional

Whether the issue's subtasks are deleted when the issue is deleted.

Responses

🟢204Returned if the request is successful.

application/json

Body

object {0}

🟠400Returned if the issue has subtasks and `deleteSubtasks` is not set to *true*.

🟠401Returned if the authentication credentials are incorrect.

🟠403Returned if the user does not have permission to delete the issue.

🟠404Returned if the issue is not found or the user does not have permission to view the issue.

Modified at 2023-07-13 03:27:27

Edit issue

Assign issue