project delete

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

stacktape project delete my-api

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, --yesboolean

Auto-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, --helpstring

Show 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)string

Project 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.

--quietboolean

Quiet

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:

stacktape project delete payments-service

Delete a test project in a script or CI job:

stacktape project delete e2e-run-42 --yes

A project with a deployed stage is kept, and the output tells you what to delete first:

Project payments-service still has 1 deployed stage: staging (eu-west-1, AWS account main). Deleting the
project never deletes stacks, so it was kept.

Hints:
  → Delete the stage first:
  → stacktape delete --stage staging --region eu-west-1 --project payments-service --aws-account main
  → Then run stacktape project delete --project payments-service again.

With --agent, the result's data.deployedStages lists the same stages.

  • delete — Delete a deployed stage and its AWS resources.
  • project list — List projects with their deployed stages.
  • project create — Create an empty project.