Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
    3. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
        1. List comments GET
        2. Get comment GET
        3. Create comment POST
        4. Update comment PATCH
        5. Remove comment DELETE
    5. Status pages
    6. Metadata
    7. Integrations

Update comment

This will update an existing comment.

You can only update a comment created by the API.

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

URL parameters

incident_id
required string

The ID of the incident

comment_id
required string

The ID of the comment

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.

200

The comment was successfully updated

Response body

{
  "data": {
    "id": "1",
    "type": "incident_comment",
    "attributes": {
      "id": 1,
      "content": "new content",
      "created_at": "2025-06-03T12:10:28.357Z",
      "updated_at": "2025-06-03T12:10:28.357Z"
    }
  }
}
404

Comment or incident was not found

Example cURL

Simple text Rich-formatted comment 
curl --request PATCH \
  --url https://uptime.betterstack.com/api/v2/incidents/1/comments/1 \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{ "content": "Updated comment content" }'
curl --request PATCH \
  --url https://uptime.betterstack.com/api/v2/incidents/1/comments/1 \
  --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._"
  }'


Previous article

Create comment

Next article

Remove comment