---
title: "Create a comment for an alert"
method: POST
path: "/alert-comments"
tags: ["comment"]
---

# Create a comment for an alert

`POST /alert-comments`

## Request body

- CommentAPIModifyCommentReq
  - `alertId` string, required — The alert ID the comment is associated with
  - `body` string, required — The body of the comment
  - `format` 'PLAIN_TEXT' | 'HTML', required — The format of the comment

## Response `200`

OK response.

- CommentAPIComment
  - `alertId` string — The alert ID the comment is associated with
  - `body` unknown
  - `createdAt` string — The date the comment was created
  - `createdBy` object — The actor who created the comment
    - `id` 'user' | 'api-token' | 'system'
    - `type` string
  - `format` 'PLAIN_TEXT' | 'HTML' — The format of the comment
  - `id` string — The comment ID
  - `updatedAt` string — The date the comment was updated
  - `updatedBy` object — The actor who updated the comment
    - `id` 'user' | 'api-token' | 'system'
    - `type` string

## Other responses

- `400` — bad_request: Bad Request response.
- `404` — not_found: Not Found response.

---

[API](https://skmtc.dev/panther/apis/panther-rest-api.md) · [All operations](https://skmtc.dev/panther/apis/panther-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panther/panther-rest-api/revisions/eb177cb9d6a1/schema)