Skip to main content

Safe Deletion

Deletion removes workloads and can remove related resources. Treat production deletion as a change that requires review.

Delete An Application​

Before deleting an application:

  • Confirm workspace and environment.
  • Confirm the app name.
  • Confirm the owner approved deletion.
  • Remove or document custom domains.
  • Confirm no users depend on the generated URL.
  • Confirm release history is no longer needed.
  • Confirm variables do not need to be migrated.

Application deletion is not a rollback. If you need to restore a version, deploy a corrected commit or promote a previous static-site deployment when available.

Delete A Service​

Services use a safer preview flow.

The delete preview can show:

  • Main service name.
  • Dependencies that will be removed.
  • Migration or deletion class.
  • Whether a storage snapshot-like protection is expected.

Read the preview before confirming.

Delete Dependency Services​

Do not manually delete a dependency service unless you understand the parent service relationship.

Preferred flow:

  1. Open the parent service.
  2. Review dependencies.
  3. Use the parent service deletion flow.
  4. Confirm the preview includes the expected resources.

Delete An Environment​

An environment must be empty before deletion.

If deletion fails:

  1. Check applications filtered to that environment.
  2. Check services in that environment.
  3. Check dependencies.
  4. Delete or move workloads.
  5. Retry deletion.

Delete An Environment Group​

Delete an environment group only after all child environments are empty and no team still uses it for deploys.

Deletion Approval Checklist​

  • Correct workspace.
  • Correct environment.
  • Correct workload.
  • Owner approval.
  • Public domains reviewed.
  • Dependencies reviewed.
  • Storage reviewed.
  • Billing impact understood.
  • Recovery path known.

After Deletion​

After deletion:

  • Refresh the dashboard.
  • Confirm the workload no longer appears.
  • Check billing usage later for storage or workload count changes.
  • Remove stale documentation or bookmarks.
  • Update external systems that pointed to the workload URL.