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

​
Overview

The Delete Check endpoint permanently removes a check from your account. This action cannot be undone and will stop all monitoring for the deleted check. Common Use Cases:
  • Check Cleanup
  • Monitoring Decommissioning
  • Resource Management
  • Account Maintenance
Deleting checks is permanent and cannot be undone. All historical data, results, and alerting will be permanently removed. Ensure you have backed up any important data before deletion.
Consider deactivating checks instead of deleting them if you want to preserve historical data while stopping monitoring.

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
string
required

Response

No Content