Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. 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. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
      1. Status pages API
      2. Status page groups
      3. Status page sections
      4. Status page resources
      5. Status page subscribers
      6. Status page reports
      7. Status page report updates
        1. List status updates per report GET
        2. Get status update GET
        3. Create status update POST
        4. Update status update PATCH
        5. Remove status update DELETE
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Update status update

Update an existing status page report update. Send only the parameters you wish to change (e.g. message).

PATCH https://incidents.betterstack.com/api/v2/status-pages/{status_page_id}/status-reports/{status_report_id}/status-updates/{status_update_id}

URL parameters

status_page_id
required string

The ID of your status page

status_report_id
required string

The ID of your status page report

status_update_id
required string

The ID of your status update

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

message
string

A message associated with the status update

notify_subscribers
boolean

Whether or not to send a notification e-mail to subscribers of the status page. If omitted, the status update keeps its current setting.

affected_resources
array of objects

An array of objects, where each object contains status_page_resource_id and status attributes. status_page_resource_id - The ID of the status page resource which you want to affect. status - One of resolved, degraded or downtime. Replaces the update's affected resources, so send the full list when you change them. If omitted, the status update keeps its current affected resources. Leave it out for a maintenance.

published_at
string

The time that will show as the time that the status update was published at (formatted in ISO 8601).

201

Returns the updated status page report update

Response body

{
  "data": {
    "id": "123456",
    "type": "status_update",
    "attributes": {
      "message": "Updated status update message",
      "published_at": "2021-12-16T16:04:09.880Z",
      "published_at_timezone": "UTC",
      "notify_subscribers": false,
      "status_report_id": 12345,
      "affected_resources": [
        {
          "status_page_resource_id": "12345",
          "status": "degraded"
        }
      ]
    }
  }
}

Example cURL

Example
curl --request PATCH \
  --url https://incidents.betterstack.com/api/v2/status-pages/123456/status-reports/12345/status-updates/123456 \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"message": "Updated status update message"}'


Previous article

Create status update

Next article

Remove status update