---
title: "Delete watcher"
method: DELETE
path: "/rest/api/2/issue/{issueIdOrKey}/watchers"
tags: ["Issue watchers"]
---

# Delete watcher

`DELETE /rest/api/2/issue/{issueIdOrKey}/watchers`

Deletes a user as a watcher of an issue.

This operation requires the **Allow users to watch issues** option to be *ON*. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details.

**[Permissions](#permissions) required:**

 *  *Browse projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.
 *  To remove users other than themselves from the watchlist, *Manage watcher list* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in.

## Path parameters

- `issueIdOrKey` string, required

## Query parameters

- `username` string
- `accountId` string

## Response `204`

Returned if the request is successful.

## Other responses

- `400` — Returned if `accountId` is not supplied.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the permission to manage the watcher list.
- `404` — Returned if the issue or the user 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.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)