---
name: tracker/jira-official:issue-update
description: Update JIRA issue fields
version: "0.5.0"
---

# Issue Update

> **Backend:** jira-official (atlassian@claude-plugins-official)

> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

Updates one or more fields on an existing JIRA issue.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| issue_key | string | Yes | JIRA issue key (e.g., `<PROJECT_KEY>-123`) |
| fields | object | Yes | Dictionary of field names to new values (e.g., `{"summary": "New title", "labels": ["BE"]}`) |

## Implementation

Uses MCP JIRA tool: `mcp__atlassian__updateJiraIssue`

```
mcp__atlassian__updateJiraIssue({
  issue_key: "<issue_key>",
  fields: {
    "<field_name>": "<value>"
  }
})
```

Use `jira-official:field-read` to discover custom field IDs before updating non-standard fields.

## Output

| Field | Type | Description |
|-------|------|-------------|
| key | string | Issue key that was updated |
| updated | string | ISO 8601 timestamp of the update |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Issue key not found | Verify the issue key and project key are correct |
| 403 | Insufficient permissions to edit the issue | Confirm the JIRA user has edit permissions on the project |
| 400 | Unknown field name in `fields` dict | Use `jira-official:field-read` to get valid field IDs |
| 400 | Field value fails validation | Check the field's allowed values or schema constraints |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- dev-task (updating issue fields such as labels, assignee, or description during development)
