Create comment

Create comment

This will create a new comment.

POST https://uptime.betterstack.com/api/v2/incidents/{incident_id}/comments

URL parameters

incident_id

required string

The ID of the incident

Headers

Authorization

required string

Bearer $TOKEN

Content_Type

string

application/json

Body parameters

content

required string

The content of the comment. Markdown is supported for formatting.

201

The comment was successfully created

Response body

{
  "data": {
    "id": "123",
    "type": "incident_comment",
    "attributes": {
      "id": 123,
      "content": "posted from API",
      "created_at": "2025-06-03T12:10:28.357Z",
      "updated_at": "2025-06-03T12:10:28.357Z"
    }
  }
}

403

Authentication failed

Example cURL

Simple text Rich-formatted comment

Copied!

curl --request POST \
  --url https://uptime.betterstack.com/api/v2/incidents/1/comments \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"content": "Posted from API"}'

curl --request POST \
  --url https://uptime.betterstack.com/api/v2/incidents/1/comments \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "content": "# 🚨 Incident Update\n\nHere is the current system status:\n\n| Component | Status       |\n|-----------|--------------|\n| API       | ✅ Operational |\n| Database  | 🔄 Restarting |\n| Cache     | ❌ Down       |\n\n_Updated automatically via API._"
  }'

Explore documentation

Example cURL