jira_patch
Partially update Jira resources like issues, comments, and worklogs using PATCH operations to modify only specified fields while leaving others unchanged.
Instructions
Partially update Jira resources. Returns TOON format by default.
IMPORTANT - Cost Optimization: Use jq param to filter response fields.
Output format: TOON (default) or JSON (outputFormat: "json")
Common operations:
Update issue fields:
/rest/api/3/issue/{issueIdOrKey}body:{"fields": {"summary": "Updated title"}}(only updates specified fields)Update comment:
/rest/api/3/issue/{issueIdOrKey}/comment/{commentId}body:{"body": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Updated comment"}]}]}}Update worklog:
/rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}body:{"timeSpentSeconds": 7200}
Note: PATCH only updates the fields you specify, leaving others unchanged.
API reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The Jira API endpoint path (without base URL). Must start with "/". Examples: "/rest/api/3/project", "/rest/api/3/search/jql", "/rest/api/3/issue/{issueIdOrKey}" | |
| queryParams | No | Optional query parameters as key-value pairs. Examples: {"maxResults": "50", "startAt": "0", "jql": "project=PROJ", "fields": "summary,status"} | |
| jq | No | JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "issues[*].{key: key, summary: fields.summary}" (extract specific fields), "issues[0]" (first result), "issues[*].key" (keys only). See https://jmespath.org | |
| outputFormat | No | Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax. | |
| body | Yes | Request body as a JSON object. Structure depends on the endpoint. Example for issue: {"fields": {"project": {"key": "PROJ"}, "summary": "Issue title", "issuetype": {"name": "Task"}}} |