Skip to main content
POST
/
v1
/
triage
/
issues
/
{id}
/
comments
Add Comment
curl --request POST \
  --url https://api.bland.ai/v1/triage/issues/{id}/comments \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "detail": "<string>",
  "resource_link_ids": [
    "<string>"
  ]
}
'
{
  "data": {
    "entry_kind": "issue",
    "id": "5a9d0fa9-27b7-414c-9e49-5fc32f240c01",
    "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
    "type": "comment",
    "actor": {
      "kind": "user",
      "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
      "label": "John Bland",
      "avatar_url": null
    },
    "detail": "@norm please look at the routing logic on the closing node, this looks like the same bug from T-1029.",
    "from_status": null,
    "to_status": null,
    "metadata": null,
    "resources": [],
    "referenced_issues": [],
    "created_at": "2026-05-07T05:26:21.449Z"
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Adds a comment to the issue’s activity feed. If the body contains @norm, the same call also dispatches a Norm investigation, creating a session if none exists. The mention is stripped before the prompt reaches Norm. The HTTP response returns once the comment is saved, so the comment is durable even if the dispatch fails.

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

id
string
required
Internal UUID of the issue.

Body Parameters

detail
string
required
Comment body. 1-4000 characters. Include @norm anywhere in the body to also dispatch a Norm investigation.
Optional array of resource link IDs (from List Resources) to attach to this comment as inline references. The dashboard renders these as chips alongside the comment.

Response

Returns 201 Created with the comment timeline entry. See List Activity for the full field list.
data
object
An IssueTimelineEntry with entry_kind: "issue" and type: "comment".
errors
null | array
null on success. Returns 404 if the issue does not exist.
{
  "data": {
    "entry_kind": "issue",
    "id": "5a9d0fa9-27b7-414c-9e49-5fc32f240c01",
    "issue_id": "4f9a7c2d-7f88-4dc4-9d1e-be83c5067f1c",
    "type": "comment",
    "actor": {
      "kind": "user",
      "id": "1f4cabe4-5f9b-4b30-bc4f-fcd3e94a5b15",
      "label": "John Bland",
      "avatar_url": null
    },
    "detail": "@norm please look at the routing logic on the closing node, this looks like the same bug from T-1029.",
    "from_status": null,
    "to_status": null,
    "metadata": null,
    "resources": [],
    "referenced_issues": [],
    "created_at": "2026-05-07T05:26:21.449Z"
  },
  "errors": null
}

Docs for agents: llms.txt