For AI agents: markdown of this page — /docs-content-en/feedback/comments.md documentation index — /llms.txt

Add a comment

POST /v1/feedback/:id/comments

Adds a comment to a ticket. Requires the vibe:feedback scope. Attachments can be added to a comment.

Parameters

Parameter Type Required Description
id (path) string yes Ticket UUID

Request fields (body)

Field Type Required Description
body string yes Comment text, 2–20000 characters
status string no New ticket status, applied together with the comment. Values as in update
attachmentIds array no Up to 5 IDs of pre-uploaded attachments. How to upload — Upload an attachment

Examples

curl — personal key

Terminal 
curl -X POST https://vibecode.bitrix24.com/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Reproduced on an empty filter, attached the request log." }'

curl — OAuth application

Terminal 
curl -X POST https://vibecode.bitrix24.com/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Reproduced on an empty filter, attached the request log." }'

JavaScript — personal key

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.com/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments',
  {
    method: 'POST',
    headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ body: 'Reproduced on an empty filter, attached the request log.' }),
  },
)
const { data } = await res.json()

JavaScript — OAuth application

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.com/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ body: 'Reproduced on an empty filter, attached the request log.' }),
  },
)
const { data } = await res.json()

Response fields

Field Type Description
success boolean Always true on success
data.id string Comment UUID
data.authorType string Who left the comment: USER or PLATFORM
data.body string Comment text
data.createdAt string Creation date (ISO 8601)
data.feedbackStatus string Ticket status after the comment
data.previousStatus string Ticket status before the comment

Response example

JSON 
{
  "success": true,
  "data": {
    "id": "61ae2a00-a7ac-416f-85cc-99873c767d3b",
    "authorType": "USER",
    "body": "Reproduced on an empty filter, attached the request log.",
    "createdAt": "2026-04-19T11:00:00.000Z",
    "feedbackStatus": "AWAITING_USER",
    "previousStatus": "NEW"
  }
}

Error response example

403 — comment without the vibe:feedback scope:

JSON 
{
  "success": false,
  "error": {
    "code": "FEEDBACK_SCOPE_REQUIRED",
    "message": "Requires management key or vibe:feedback scope"
  }
}

Errors

HTTP Code Description
400 VALIDATION_ERROR body shorter than 2 or longer than 20000 characters, or attachmentIds longer than 5
403 FEEDBACK_SCOPE_REQUIRED Comment on someone else's ticket without the vibe:feedback scope. The ticket author passes without the scope — see "Known specifics"
404 NOT_FOUND The ticket does not exist or is not accessible to the key
409 FEEDBACK_CLOSED An author comment on an already closed ticket
401 MISSING_API_KEY The X-Api-Key header was not passed

For the full list of common API errors, see Errors.

Known specifics

A comment can change the status. By default a comment moves the ticket to AWAITING_USER. To set a different status, pass status in the body — values as in update. The feedbackStatus and previousStatus fields in the response show the status after and before the comment.

The author comments on their own ticket without the scope. If the request uses the same key that created the ticket, the comment passes without the vibe:feedback scope: the author check runs before the scope check. The scope is only needed for comments on other people's tickets.

See also