Create a new comment for an incident

POST

/v1/incidents/{id}/comments

curl --request POST \
  --url https://api.adversarial.com/api/v1/incidents/INC-00001/comments \
  --header 'Content-Type: application/json' \
  --data '{ "value": "example" }'

• Production
• Staging
• Local

Parameters

Path Parameters

id

required

string

The ID of the incident to create a comment for — INC-00001 (case-insensitive) or a bare number

Example

INC-00001

Request Body^required

Media typeapplication/json

object

value

required

string

Example^generated

{
  "value": "example"
}

Responses

201

Comment created

Media typeapplication/json

object

created_date

required

string format: date-time

id

required

string format: uuid

updated_date

string | null format: date-time

user

required

A User as returned by the API.

Profile images are not embedded — clients fetch them from GET /api/v1/{icon} when icon is Some.

object

email

required

string

first_name

required

string

icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null

id

required

string format: uuid

last_name

required

string

value

required

string

Example^generated

{
  "created_date": "2026-04-15T12:00:00Z",
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "updated_date": "2026-04-15T12:00:00Z",
  "user": {
    "email": "example",
    "first_name": "example",
    "icon": "example",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "last_name": "example"
  },
  "value": "example"
}

404

Incident not found