jira issue watchers add¶
- Usage:
jira issue watchers add KEY... [flags]
Add a user as a watcher on one or more issues. Use --user me for the active profile, accountId:<id> for an exact Jira account, or an email when a live Jira lookup is acceptable.
Plain --dry-run is local-only and can resolve only me or accountId:<id> from local state. Add --validate-remote to make dry-run perform a read-only user lookup.
User¶
--user <IDENTIFIER>¶
User identifier (me / accountId:<id> / email)
Safety¶
--dry-run¶
Local preview only — does not contact Jira
Validation¶
--no-readback¶
Skip the post-mutation GET
--validate-remote¶
Resolve --user against Jira (read-only); use with --dry-run
Execution¶
-p --parallelism <N>¶
Maximum concurrent requests (1-16)
Default: 1
Output fields¶
With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.
| Field | Type | Description |
|---|---|---|
account_id |
string | Legacy no-readback outcome containing the attempted account ID. |
account_id_resolved |
string | The resolved Jira account ID, when resolution succeeded. |
attempted |
boolean | No-readback outcome confirming the mutation request was attempted. |
dry_run |
boolean | |
is_watching |
boolean | Watching state returned by the optional post-mutation readback. |
issue.id |
string | |
issue.key |
string | |
issue.self |
string | |
user |
string | The original user identifier supplied by the caller. |
user_resolved |
boolean | Whether the user identifier was resolved to a Jira account ID. |
was_already_watching |
boolean | Whether the requested state already held, when post-mutation readback can determine it. |
watch_count |
integer | Watcher count returned by the optional post-mutation readback. |
watchers[].account_id |
string | |
watchers[].display_name |
string | |
watchers[].email_address |
string |
Examples¶
jira issue watchers add PROJ-123 --user me # (1)!
jira issue watchers add PROJ-123 --user accountId:5b10ac8d82e05b22cc7d4ef5 # (2)!
jira issue watchers add PROJ-123 --user me --dry-run # (3)!
- Add yourself as a watcher
- Add a watcher by account id
- Preview adding a watcher without mutating