# Remove a release

Removes an existing release. The removal is permanent, but a release that still receives error events is re-detected automatically when its next event arrives. A release that was registered by mistake and has no error events stays removed.

[endpoint]
base_url = "https://errors.betterstack.com"
path = "/api/v1/releases/{id}"
method = "DELETE"

[[path_param]]
name = "id"
description = "The ID of the release to remove."
required = true
type = "string"

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

[responses]
[[response]]
status = 204
description = '''No Content'''
body = ''''''

[[response]]
status = 401
description = '''Unauthorized'''
body = '''{
  "errors": "Invalid authentication"
}'''

[[response]]
status = 404
description = '''Not Found'''
body = '''{
  "errors": "Resource with the provided ID was not found"
}'''
[/responses]

#### Example cURL

```shell
[label Example]
curl --request DELETE \
  --url https://errors.betterstack.com/api/v1/releases/456 \
  --header "Authorization: Bearer $TOKEN"
```