checkly destroy

Destroy all project resources from your Checkly account.

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.

Prerequisites

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]

Option	Required	Description
--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":

Related Commands

• checkly deploy - Deploy resources to Checkly
• checkly test - Test your setup before deployment