Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. 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. 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 subscribers
        1. List status page subscribers GET
        2. Get status page subscriber GET
        3. Create status page subscriber POST
        4. Update status page subscriber PATCH
        5. Remove status page subscriber DELETE
        6. Response attributes
      6. Status page reports
      7. Status page report updates
    6. Metadata
    7. Integrations
    8. Team members

Update status page subscriber

Updates which status page resources an email subscriber receives notifications for.

Only status_page_resource_ids can be changed. To change an email address, remove the old subscriber and create a new one.

PATCH https://uptime.betterstack.com/api/v2/status-pages/{status_page_id}/subscribers/{subscriber_id}

URL parameters

status_page_id
required string

The ID of your status page.

subscriber_id
required string

The ID of the subscriber.

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

status_page_resource_ids
required array

The status page resources this subscriber receives updates for. Use [] for all resources. Get valid resource IDs from GET /api/v2/status-pages/{status_page_id}/resources.

200

Returns the updated status page subscriber.

Response body

{
  "data": {
    "id": "123456789",
    "type": "status_page_subscriber",
    "attributes": {
      "status_page_id": 987654321,
      "email": "customer@example.com",
      "status_page_resource_ids": [
        112233,
        112234
      ],
      "confirmed_at": "2026-04-29T14:30:00.000Z",
      "created_at": "2026-04-29T14:30:00.000Z",
      "updated_at": "2026-04-29T15:00:00.000Z"
    }
  }
}

Example cURL

Example
curl --request PATCH \
  --url https://uptime.betterstack.com/api/v2/status-pages/987654321/subscribers/123456789 \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "status_page_resource_ids": [112233, 112234]
  }'


Looking for the details of a specific parameter?

Explore the list of all status page subscriber API parameters.

Previous article

Create status page subscriber

Next article

Remove status page subscriber