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

Remove status page subscriber

Removes an email subscriber from a status page. You can remove the subscriber by ID or by exact email address.

Removing a subscriber creates an unsubscribe record for that email address.

DELETE 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

DELETE https://uptime.betterstack.com/api/v2/status-pages/{status_page_id}/subscribers?email={email}

URL parameters

status_page_id
required string

The ID of your status page.

Query parameters

email
required string

The exact subscriber email address.

Headers

Authorization
required string

Bearer $TOKEN

204

The subscriber was removed.

Example cURL

Remove by ID
curl --request DELETE \
  --url https://uptime.betterstack.com/api/v2/status-pages/987654321/subscribers/123456789 \
  --header "Authorization: Bearer $TOKEN"


Remove by email
curl --request DELETE \
  --url "https://uptime.betterstack.com/api/v2/status-pages/987654321/subscribers?email=customer@example.com" \
  --header "Authorization: Bearer $TOKEN"


Previous article

Update status page subscriber

Next article

Response attributes