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
        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
        6. Response attributes
      4. Status page resources
      5. Status page reports
      6. Status page report updates
    6. Metadata
    7. Integrations

Update status page section

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

PATCH https://uptime.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 position of this resource on your status page, indexed from zero. If you don't specify a position, we add the resource to the end of the status page. When you specify a position of an existing resource, we add the resource to this position and shift resources below to accommodate.

200

Response body

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