Delete a Design

Permanently delete a design you own, and understand what deletion does and does not affect.

Deleting a design removes the design record and its workspace mappings in one transaction. There is no trash and no restore. Export a copy first if you might need it. See Export Designs.

The server allows the design’s owner or a provider administrator. Organization administrators, workspace owners, and collaborators with a share grant cannot delete a design (403 “unauthorized for the operation”). Layer5 Cloud hides its Delete action for roles without the Delete a Design permission, but the server decides by ownership, not by the key. To remove a design from a workspace without deleting it, use the workspace’s remove action instead.

Delete is a File menu action, disabled on an empty canvas. A confirmation reads Delete <name> design with the text Are you sure you want to delete <name>?. You confirm with a single button. There is no type-to-confirm step.

If you delete the open design, the editor resets to a new blank design. Deleting a different design from a list does not change the canvas. Kanvas shows no success message for a delete, while Layer5 Cloud shows <name> deleted.

ItemEffect
Deployed resourcesNone. Deleting does not undeploy anything from clusters. Undeploy first if you want the resources gone.
Clones, Save as copies, merged-in componentsUntouched. They are independent.
Share grantsRemoved with the design.
Collaboration sessionEnds when the canvas resets.
Published designA delete-from-catalog workflow runs against the catalog repository. If it fails, the failure is logged only. The catalog request record stays.
Catalog clones made by othersRemain.

An event records who deleted which design.

Layer5 Cloud’s catalog designs table offers multi-select delete with the prompt Are you sure that you want to delete <N> designs?. It issues one delete per selected design, so a partial failure shows per-design errors. Kanvas has no multi-select delete.

ResponseCause
400 “please provide a valid design ID”The id is invalid.
404 “design not found”The design does not exist. A missing row can also surface as 500 “failed to get design from database”.
403You are not the owner or a provider administrator.

Related Reading