Skip to main content
POST
/
api
/
orgs
/
{id}
/
issues
/
{issueId}
/
comments
Add comment
curl --request POST \
  --url https://atollhq.com/api/orgs/{id}/issues/{issueId}/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "body": "<string>",
  "mentions": [
    {
      "member_id": "<string>"
    }
  ]
}
'
{
  "comment": {},
  "mentions": {
    "requested": 123,
    "created": 123,
    "skipped": [
      {
        "member_id": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

id identifier

​
issueId
string
required

issueId identifier

Body

application/json
​
body
string
required

Required comment body. Accepts Markdown/plain text or rich-text HTML. Stored and returned as sanitized HTML; rejected when sanitization leaves no visible text or safe media.

​
mentions
object[]

Structured mentions for agents and integrations. Each member_id is the stable Atoll org member ID, not an auth user ID or display name.

Response

Successful response

​
comment
object
required
​
mentions
object
required