Jira

Jira Issue Comments API

Manage comments on issues.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /issue/{issueIdOrKey}/comment List an issue's comments via the unversioned path · Jira Get Comments #
Ask an LLM
“Is there a legacy unversioned path for reading an issue's comments?”
“Can the older comment listing outside /rest/api/3 sort comments by created date?”
Tell an agent
Using the unversioned /issue path, list comments on issue {issueIdOrKey}.
Via the legacy unversioned comment path, get comments on {issueIdOrKey} ordered by {orderBy}.
POST /issue/{issueIdOrKey}/comment Comment on an issue via the unversioned path · Jira Add Comment #
Ask an LLM
“Can I post an ADF comment through the older unversioned issue comment path?”
“Does the legacy unversioned add-comment endpoint support visibility restrictions?”
Tell an agent
Using the unversioned /issue path, add comment {body} to issue {issueIdOrKey}.
Via the legacy unversioned path, comment {body} on {issueIdOrKey} visible only to {visibility}.
POST /rest/api/3/comment/list Fetch several comments by their IDs · Get comments by IDs #
Ask an LLM
“Can I fetch a batch of comments across issues when I already know their IDs?”
“Which comments from a list of IDs am I allowed to see?”
Tell an agent
Get comments with IDs {ids}.
Fetch comments {ids} expanded with {expand}.
GET /rest/api/3/issue/{issueIdOrKey}/comment List the comments on an issue · Get comments #
Ask an LLM
“How do I read all the comments on an issue?”
“Can I page through an issue's comments newest first?”
Tell an agent
List comments on issue {issueIdOrKey}.
Show {maxResults} comments from issue {issueIdOrKey} ordered by {orderBy}.
POST /rest/api/3/issue/{issueIdOrKey}/comment Add a comment to an issue · Add comment #
Ask an LLM
“How do I post a comment on an issue?”
“Can I restrict a new comment so only a certain group or role sees it?”
Tell an agent
Comment {body} on issue {issueIdOrKey}.
Add comment {body} to {issueIdOrKey} visible only to {visibility}.
DELETE /rest/api/3/issue/{issueIdOrKey}/comment/{id} Delete a comment from an issue · Delete comment #
Ask an LLM
“How do I delete a comment on an issue?”
“What permissions are needed to remove someone else's comment?”
Tell an agent destructive · confirm first
Delete comment {id} on issue {issueIdOrKey}.
Remove comment {id} from {issueIdOrKey}.
GET /rest/api/3/issue/{issueIdOrKey}/comment/{id} Get a single comment on an issue · Get comment #
Ask an LLM
“How do I retrieve one specific comment on an issue?”
“Can I get the rendered HTML of a single comment?”
Tell an agent
Get comment {id} on issue {issueIdOrKey}.
Show comment {id} from {issueIdOrKey} expanded with {expand}.
PUT /rest/api/3/issue/{issueIdOrKey}/comment/{id} Edit an existing comment · Update comment #
Ask an LLM
“Can I edit a comment I already posted on an issue?”
“Is there a way to update a comment without notifying watchers?”
Tell an agent
Change comment {id} on issue {issueIdOrKey} to say {body}.
Edit comment {id} on {issueIdOrKey} to {body} with notify users set to {notifyUsers}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
RateLimits
https://developer.atlassian.com/cloud/jira/platform/rate-limiting/
📖
GettingStarted
https://developer.atlassian.com/cloud/jira/platform/getting-started/
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
GettingStarted
https://developer.atlassian.com/cloud/jira/software/getting-started-with-forge/
📖
Authentication
https://developer.atlassian.com/cloud/jira/software/security-overview/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-comments-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/asyncapi/jira-webhooks-asyncapi.yml

Code Examples

💻
CodeExamples
https://developer.atlassian.com/cloud/jira/software/rest/intro/#examples

Other Resources

🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/platform/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/platform/security-overview/
🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/software/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/software/security-overview/
🔗
ChangeLog
https://developer.atlassian.com/cloud/jira/service-desk/changelog/
🔗
Security
https://developer.atlassian.com/cloud/jira/service-desk/security-overview/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-issue-comments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-issue-comments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Jira Issue Comments API
  x-refined-note:
  - x-atlassian-api-version differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Issue Comments across 2 of this provider''s published API definitions: jira-cloud-platform-rest-api-openapi.yml, jira-platform-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{domain}.atlassian.net/rest/api/3
  description: Jira Cloud instance
  variables:
    domain:
      description: Your Jira Cloud site subdomain (e.g., your-company).
      default: your-domain
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-comments-api-openapi.yml