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
        1. List status page sections GET
        2. Get status page section GET
        3. Create status page section POST
        4. Update status page section PATCH
        5. Remove status page section DELETE
      4. Status page resources
      5. Status page subscribers
      6. Status page reports
      7. Status page report updates
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Update status page section

Update an existing status page section. Send only the parameters you wish to change (e.g. name)

PATCH https://incidents.betterstack.com/api/v2/status-pages/{status_page_id}/sections/{section_id}

URL parameters

status_page_id
required string

The ID of your status page

section_id
required string

The section you want to update

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

name
string

The name of the section. Leave blank to hide the section header.

position
integer

The new position of this section on your status page, counted from the top and indexed from zero. The sections in between shift to accommodate. If you don't specify a position, the section keeps its current one.

fixed_position
boolean

If true, the section is saved at exactly position and the other sections keep their positions. Defaults to false.

200

Response body

{
  "data": {
    "id": "12345",
    "type": "status_page_section",
    "attributes": {
      "name": "EU datacenter 2",
      "position": 0,
      "status_page_id": 123456789
    }
  }
}

Example cURL

Example
curl --request PATCH \
  --url https://incidents.betterstack.com/api/v2/status-pages/123456789/sections/12345 \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "EU datacenter 2"
}'


Previous article

Create status page section

Next article

Remove status page section