Skip to main content
POST
Add Comment

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

string
required
Your API key for authentication.

Path Parameters

string
required
Internal UUID of the issue.

Body Parameters

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.
object
An IssueTimelineEntry with entry_kind: "issue" and type: "comment".
null | array
null on success. Returns 404 if the issue does not exist.

Docs for agents: llms.txt