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

Create status update

Returns the newly created status page report update.

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

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

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

message
required 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. Default: true. Subscribers are notified at published_at.

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. Resources you leave out keep their status from earlier updates. Required unless the report is a maintenance, whose affected resources are set on the report. Leave it out there.

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

201

Return the newly created status page report update

Response body

{
  "data": {
    "id": "123456",
    "type": "status_update",
    "attributes": {
      "message": "First 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 POST \
  --url https://incidents.betterstack.com/api/v2/status-pages/123456/status-reports/12345/status-updates \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "First status update message",
    "affected_resources": [{"status_page_resource_id": "12345", "status": "degraded"}]
}'


Previous article

Get status update

Next article

Update status update