DELETE
/
v1
/
check-groups
/
{id}
Delete a check group.
curl --request DELETE \
  --url https://api.checklyhq.com/v1/check-groups/{id} \
  --header 'Authorization: <api-key>'
This response does not have an example.

​
Overview

The Delete Check Group endpoint permanently removes a check group from your account. This action deletes the group but preserves individual checks, which become ungrouped. Common Use Cases:
  • Group Cleanup
  • Organization Restructuring
  • Resource Management
  • Group Decommissioning
Deleting check groups is permanent. Member checks will become ungrouped but remain active. Group-specific settings and configurations will be lost.
Individual checks are preserved when deleting groups. Consider reassigning checks to other groups before deletion if group organization is important.

Authorizations

​
Authorization
string
header
required

The Checkly Public API uses API keys to authenticate requests. You can get the API Key here.

Your API key is like a password: keep it secure!

Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID.

For example, set Authorization header while using cURL:

curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"

Headers

​
x-checkly-account
string

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Path Parameters

​
id
integer
required

Response

No Content