jira_update_issue
Update a Jira issue's fields including summary, markdown description, simple fields, and rich text fields with automatic Atlassian Document Format conversion.
Instructions
Updates fields on a Jira issue.
Args:
issue_key: The issue key (e.g. "PROJ-123").
summary: New summary text.
description: New description in markdown. Supports headings, bold,
italic, strikethrough, links, code blocks, lists, tables, etc.
additional_fields: Dict of field_id -> value for simple fields
(plain text, dates, numbers, selects).
Use jira_list_fields to discover field IDs.
Example: {"duedate": "2026-04-01", "labels": ["bug"]}
rich_text_fields: Dict of field_id -> markdown string for rich text
fields that need ADF conversion (e.g. Developer Notes,
Deployment Info). These get converted to Atlassian Document
Format automatically.
Example: {"customfield_10402": "## PlanStep 1
Step 2"}
Mentioning users (in description and rich_text_fields): First call jira_search_users to find the accountId, then use @[accountId] in the text (e.g. @[712020:abc123]).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_key | Yes | ||
| summary | No | ||
| description | No | ||
| additional_fields | No | ||
| rich_text_fields | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |