Skip to main content
The checkly destroy command removes all resources associated with your project from your Checkly account, including checks, check groups, alert channels, maintenance windows, and other project-defined resources.
Before using , ensure you have:
  • An initialized Checkly CLI project
  • At least one check or resource defined in your project
  • Valid Checkly account authentication (run npx checkly login if needed)
  • A checkly.config.ts or checkly.config.js configuration file
For additional setup information, see CLI overview.
This command permanently deletes resources from your Checkly account. This action cannot be undone.

​
Usage

The basic command destroys all project resources with a confirmation prompt.
Terminal
npx checkly destroy [options]
OptionRequiredDescription
--config, -c-The Checkly CLI configuration file. If not passed, uses the checkly.config.ts|js file in the current directory.
--force, -f-Force mode. Skips the confirmation dialog.
--preserve-resources-Delete only the project, detaching its resources so they remain in your Checkly account.

​
Command Options

​
--config, -c
string
Specify a particular configuration file to use instead of the default checkly.config.ts or checkly.config.js.Usage:
Terminal
npx checkly destroy --config=<file-path>
npx checkly destroy -c=<file-path>
Examples:
Terminal
$ npx checkly destroy --config="./checkly.staging.config.ts"
​
--force, -f
boolean
Skip confirmation dialogs and proceed with the operation.Usage:
Terminal
npx checkly destroy --force
npx checkly destroy -f
Use with extreme caution as this command option bypasses safety prompts.
​
--preserve-resources
boolean
Available since CLI version 7.10.0.
Delete the project but preserve all of its resources (checks, groups, alert channels, dashboards, etc.) in your Checkly account. The resources are detached from the CLI project and become regular account-level resources that are no longer managed by the CLI.Use this when you want to stop managing resources as code but keep them running in your account.Usage:
Terminal
npx checkly destroy --preserve-resources
Examples:
Terminal
$ npx checkly destroy --preserve-resources --force

​
What Gets Destroyed

The destroy command removes the all the resources managed by the specified project. These resources could include:
  • Checks (API, Browser, Heartbeat, etc.)
  • Monitors (URL, TCP, DNC, etc.)
  • Check Groups and their configurations
  • Alert Channels defined in your project
  • Maintenance Windows created via CLI
  • Private Locations (if managed by the project)
When run with --preserve-resources, only the project itself is deleted. All of the above resources remain in your Checkly account as regular account-level resources and are no longer tracked by the CLI.

​
Safety Considerations

By default, the command prompts for confirmation:
Terminal
$ npx checkly destroy

? Are you sure you want to delete all resources in project "Website Monitoring" for account "Monitoring as Code"?
Please confirm by typing the project name "Website Monitoring":