---
title: "Delete issue"
method: DELETE
path: "/rest/api/3/issue/{issueIdOrKey}"
tags: ["Issues"]
---

# 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](#permissions) required:**

 *  *Browse projects* and *Delete issues* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Path parameters

- `issueIdOrKey` string, required

## Query parameters

- `deleteSubtasks` 'true' | 'false'

## Response `204`

Returned if the request is successful.

## Other responses

- `400` — Returned if the issue has subtasks and `deleteSubtasks` is not set to *true*.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the user does not have permission to delete the issue.
- `404` — Returned if the issue is not found or the user does not have permission to view the issue.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/ec7f275dfee5/schema)