Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
  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
    5. Status pages
      1. Status pages API
      2. Status page groups
      3. Status page sections
      4. Status page resources
      5. Status page reports
      6. 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
        6. Response attributes
    6. Metadata
    7. Integrations

Update status update

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

PATCH https://uptime.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 email to subscribers of the status page. Default: false

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 - Has to be maintenance if report_type is set to maintenance. Otherwise has to be one of resolved, degraded or downtime.

published_at
string

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

200

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://uptime.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