The project delete command deletes a project from the current Stacktape organization. The Console removes the
project with its deploy history, stage settings and build runner. Use it to clean up projects you no longer need, such
as test projects created by automation.
The command never deletes AWS stacks. If the project still has deployed stages in a connected AWS account, it refuses,
lists the stages and prints the stacktape delete command for each of them. Delete those stages first,
then run project delete again.
You need the projects:delete permission on the project. Owners and Admins have it.
Usage
In a terminal, you confirm by typing the project name. Without a terminal, for example in CI or with --agent, add
--yes; otherwise the command fails with CONFIRMATION_REQUIRED. The Stacktape MCP server passes --yes only after
you confirm the deletion.
CLI reference
stacktape project delete <project>CLI options-y, --yesbooleanAuto-Confirm Operation
Confirms an operation that would otherwise ask first: deleting a stack, an update that may delete stateful resources, creating a project that does not exist yet, and the other deletions that ask.
Without a terminal to ask in (CI, --agent, machine-readable output), such an operation fails with CONFIRMATION_REQUIRED unless this flag is set. --agent does not confirm anything.
-h, --helpstringShow Help
If provided, the command will not execute and will instead print help information.
--log-level"info" | "debug" | "error"Log Level
The level of logs to print to the console.
info: Basic information about the operation.error: Only errors.debug: Detailed information for debugging.
--project (positional 1)stringProject Name
The name of the Stacktape project for this operation.
Commands that target a stack take it from projectName in the project's config when the flag is absent.
--quietbooleanQuiet
Hide progress, banners, success messages and hints. Command output, warnings and errors are still printed.
Examples
Delete a project and confirm by typing its name:
Delete a test project in a script or CI job:
A project with a deployed stage is kept, and the output tells you what to delete first:
With --agent, the result's data.deployedStages lists the same stages.
Related commands
delete— Delete a deployed stage and its AWS resources.project list— List projects with their deployed stages.project create— Create an empty project.