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
      1. Heartbeats API
      2. Heartbeat groups API
        1. List heartbeat groups GET
        2. Get heartbeat group GET
        3. List heartbeats in group GET
        4. Create heartbeat group POST
        5. Update heartbeat group PATCH
        6. Remove heartbeat group DELETE
        7. Response attributes
    4. On-call & incidents
    5. Status pages
    6. Metadata
    7. Integrations

Remove heartbeat group

Permanently deletes an existing heartbeat group.

DELETE https://uptime.betterstack.com/api/v2/heartbeat-groups/{heartbeat_group_id}

URL parameters

heartbeat_group_id
required string

The ID of the heartbeat group you want to delete.

Headers

Authorization
required string

Bearer $TOKEN

204

Returns empty body

Example cURL

 
curl --request DELETE \
  --url https://uptime.betterstack.com/api/v2/heartbeat-groups/95251342 \
  --header "Authorization: Bearer $TOKEN"

Previous article

Update heartbeat group

Next article

Response attributes