Delete

Beginner

Concept

Overview

If you want to permanently delete a specific canister or all canisters for a project, you can use the dfx canister delete command.

Deleting a canister removes the canister identifier, code, and state. Before you can delete a canister, you must first stop the canister to clear any pending message requests or replies.

Errors related to canister deletion

Common errors related to canister deletion include:

• Delete canister not stopped.
• Delete canister self.
• Delete canister queue not empty.