# Remove heartbeat group

Permanently deletes an existing heartbeat group.

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/heartbeat-groups/{heartbeat_group_id}"
method = "DELETE"

[[path_param]]
name = "heartbeat_group_id"
description = "The ID of the heartbeat group you want to delete."
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 204
description = '''Returns empty body'''
body = ''''''
[/responses]

#### Example cURL
```shell
curl --request DELETE \
  --url https://uptime.betterstack.com/api/v2/heartbeat-groups/95251342 \
  --header "Authorization: Bearer $TOKEN"
```
[info]
#### Looking for the details of a specific parameter?
Explore [the list of all heartbeat groups API parameters](https://betterstack.com/docs/uptime/api/heartbeat-groups-api-response-params/)
[/info]