Add watcher

POST

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

Adds a user as a watcher of an issue by passing the account ID of the user. For example, "5b10ac8d82e05b22cc7d4ef5". If no user is specified the calling user is added.

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 for details.

Permissions required:

Browse projects project permission for the project that the issue is in.

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

To add users other than themselves to the watchlist, Manage watcher list project permission for the project that the issue is in.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/issue//watchers' \
--header 'Content-Type: application/json' \
--data-raw '"string"'

Response Example

204 - Example 1

null

Request

Path Params

issueIdOrKey

string

required

The ID or key of the issue.

Body Params application/json

string

optional

Examples

Responses

🟢204Returned if the request is successful.

application/json

Body

No schema defined

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have the permission to manage the watcher list.

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

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

Get issue watchers

Delete watcher