# Comments
A comment is a piece of text that can be added to an issue to provide additional information or to update the issue's status. Comments can be added by users who have permission to view and edit the issue, and can be used for a variety of purposes, such as:
1. Providing context or additional details about an issue.
2. Sharing progress or updates on the issue's status.
3. Asking questions or requesting feedback from other team members.
4. Acknowledging or responding to other comments or feedback.
5. Notifying other users of relevant information or changes.
* **Mention your teammates:** If you need someone to know about a comment, you can mention them in it. Type @ followed by their name, then choose the right person from the list. The person you mention will be notified about your comment and can quickly jump to the issue to see what's happening.
* **Apply comment permissions:** If your comment is only meant for a specific Jira group or project role, comment permissions let you restrict your comments to the appropriate audience. When writing your comment, click the lock icon under it and choose a Jira group or project role to restrict it to.
## Get comments
`GET /rest/api/{2-3}/issue/{issueIdOrKey}/comment`
Returns all comments for an issue.
{% code fullWidth="true" %}
```go
package main
import (
"context"
"github.com/ctreminiom/go-atlassian/v2/jira/v2"
"github.com/ctreminiom/go-atlassian/v2/jira/v3"
"log"
"os"
)
func main() {
var (
host = os.Getenv("HOST")
mail = os.Getenv("MAIL")
token = os.Getenv("TOKEN")
)
atlassianV2, err := v2.New(nil, host)
if err != nil {
return
}
atlassianV2.Auth.SetBasicAuth(mail, token)
richTextComments, response, err := atlassianV2.Issue.Comment.Gets(context.Background(), "KP-2", "", nil, 0, 50)
if err != nil {
log.Fatal(err)
}
log.Println("HTTP Endpoint Used", response.Endpoint)
for _, comment := range richTextComments.Comments {
log.Println(comment.ID, comment.Created, comment.Body)
}
atlassianV3, err := v3.New(nil, host)
if err != nil {
return
}
atlassianV3.Auth.SetBasicAuth(mail, token)
adfComments, response, err := atlassianV3.Issue.Comment.Gets(context.Background(), "KP-2", "", nil, 0, 50)
if err != nil {
log.Fatal(err)
}
log.Println("HTTP Endpoint Used", response.Endpoint)
for _, adfComment := range adfComments.Comments {
log.Println(adfComment.Body.Type)
}
}
```
{% endcode %}
## Get comment
`GET /rest/api/{2-3}/issue/{issueIdOrKey}/comment/{id}`
Returns a comment.
{% code fullWidth="true" %}
```go
package main
import (
"context"
"github.com/ctreminiom/go-atlassian/v2/jira/v2"
"log"
"os"
)
func main() {
var (
host = os.Getenv("HOST")
mail = os.Getenv("MAIL")
token = os.Getenv("TOKEN")
)
atlassian, err := v2.New(nil, host)
if err != nil {
return
}
atlassian.Auth.SetBasicAuth(mail, token)
comment, response, err := atlassian.Issue.Comment.Get(context.Background(), "KP-2", "10011")
if err != nil {
log.Fatal(err)
}
log.Println(response.Endpoint)
log.Println(comment.ID, comment.Created)
}
```
{% endcode %}
## Delete comment
`DELETE /rest/api/{2-3}/issue/{issueIdOrKey}/comment/{id}`
Deletes a comment.
{% code fullWidth="true" %}
```go
package main
import (
"context"
"github.com/ctreminiom/go-atlassian/v2/jira/v2"
"log"
"os"
)
func main() {
var (
host = os.Getenv("HOST")
mail = os.Getenv("MAIL")
token = os.Getenv("TOKEN")
)
atlassian, err := v2.New(nil, host)
if err != nil {
return
}
atlassian.Auth.SetBasicAuth(mail, token)
response, err := atlassian.Issue.Comment.Delete(context.Background(), "KP-2", "10011")
if err != nil {
log.Fatal(err)
}
log.Println("HTTP Endpoint Used", response.Endpoint)
}
```
{% endcode %}
## Add comment
`POST /rest/api/{2-3}/issue/{issueIdOrKey}/comment`
Adds a comment to an issue.
{% code fullWidth="true" %}
```go
package main
import (
"context"
"github.com/ctreminiom/go-atlassian/v2/jira/v2"
"github.com/ctreminiom/go-atlassian/pkg/infra/models"
"log"
"os"
)
func main() {
var (
host = os.Getenv("HOST")
mail = os.Getenv("MAIL")
token = os.Getenv("TOKEN")
)
atlassian, err := v2.New(nil, host)
if err != nil {
return
}
atlassian.Auth.SetBasicAuth(mail, token)
atlassian.Auth.SetUserAgent("curl/7.54.0")
payload := &models.CommentPayloadSchemeV2{
Body: "test",
}
newComment, response, err := atlassian.Issue.Comment.Add(context.Background(), "KP-2", payload, nil)
if err != nil {
log.Fatal(err)
}
log.Println("HTTP Endpoint Used", response.Endpoint)
log.Println(newComment.ID)
}
```
{% endcode %}
## Atlassian Document Format
The Atlassian Document Format (ADF) represents rich text stored in Atlassian products. For example, in Jira Cloud platform, the text in issue comments and in `textarea` custom fields is stored as ADF, here's a bundle of examples you can use in order to create custom body messages.
### Example 1
{% code fullWidth="true" %}
```go
commentBody := jira.CommentNodeScheme{}
commentBody.Version = 1
commentBody.Type = "doc"
//Append Header
commentBody.AppendNode(&jira.CommentNodeScheme{
Type: "heading",
Attrs: map[string]interface{}{"level": 1},
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Header 1",
},
},
})
//Append Lorem text
commentBody.AppendNode(&jira.CommentNodeScheme{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore " +
"et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip " +
"ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore " +
"eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui " +
"officia deserunt mollit anim id est laborum",
},
},
})
//Append Nested Panel Data
commentBody.AppendNode(&jira.CommentNodeScheme{
Type: "panel",
Attrs: map[string]interface{}{"panelType":"note"},
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Excepteur ",
Marks: []*jira.MarkScheme{
{Type: "textColor", Attrs: map[string]interface{}{"color":"#6554c0"}},
},
},
{
Type: "text",
Text: "sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum",
},
},
},
},
})
//Append Heading Title
commentBody.AppendNode(&jira.CommentNodeScheme{
Type: "heading",
Attrs: map[string]interface{}{"level": 2},
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Links",
},
},
})
//Append bulletList
commentBody.AppendNode(&jira.CommentNodeScheme{
Type: "bulletList",
Content: []*jira.CommentNodeScheme{
{
Type: "listItem",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Google.com",
Marks: []*jira.MarkScheme{
{
Type: "link",
Attrs: map[string]interface{}{"href": "https://www.google.com/"},
},
},
},
},
},
},
},
{
Type: "listItem",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Facebook.com",
Marks: []*jira.MarkScheme{
{
Type: "link",
Attrs: map[string]interface{}{"href": "https://www.facebook.com/"},
},
},
},
},
},
},
},
},
})
```
{% endcode %}
### Example 2
{% code fullWidth="true" %}
```go
commentBody := jira.CommentNodeScheme{}
commentBody.Version = 1
commentBody.Type = "doc"
//Create the Tables Headers
tableHeaders := &jira.CommentNodeScheme{
Type: "tableRow",
Content: []*jira.CommentNodeScheme{
{
Type: "tableHeader",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Header 1",
Marks: []*jira.MarkScheme{
{
Type: "strong",
},
},
},
},
},
},
},
{
Type: "tableHeader",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Header 2",
Marks: []*jira.MarkScheme{
{
Type: "strong",
},
},
},
},
},
},
},
{
Type: "tableHeader",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{
Type: "text",
Text: "Header 3",
Marks: []*jira.MarkScheme{
{
Type: "strong",
},
},
},
},
},
},
},
},
}
row1 := &jira.CommentNodeScheme{
Type: "tableRow",
Content: []*jira.CommentNodeScheme{
{
Type: "tableCell",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{Type: "text", Text: "Row 00"},
},
},
},
},
{
Type: "tableCell",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{Type: "text", Text: "Row 01"},
},
},
},
},
{
Type: "tableCell",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{Type: "text", Text: "Row 02"},
},
},
},
},
},
}
row2 := &jira.CommentNodeScheme{
Type: "tableRow",
Content: []*jira.CommentNodeScheme{
{
Type: "tableCell",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{Type: "text", Text: "Row 10"},
},
},
},
},
{
Type: "tableCell",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{Type: "text", Text: "Row 11"},
},
},
},
},
{
Type: "tableCell",
Content: []*jira.CommentNodeScheme{
{
Type: "paragraph",
Content: []*jira.CommentNodeScheme{
{Type: "text", Text: "Row 12"},
},
},
},
},
},
}
commentBody.AppendNode(&jira.CommentNodeScheme{
Type: "table",
Attrs: map[string]interface{}{"isNumberColumnEnabled": false, "layout": "default"},
Content: []*jira.CommentNodeScheme{tableHeaders, row1, row2},
})
```
{% endcode %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.go-atlassian.io/jira-software-cloud/issues/comments.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.