Guide

Deleting Your Project

Understanding the permanent consequences and how to protect yourself

Deleting a Zuvo project is a permanent and irreversible action. Before proceeding, understand the full scope of what will be deleted and take precautions to prevent accidental data loss.

What gets deleted

When you delete a project, all artifacts are permanently removed and you cannot recover them. Some of these artifacts includes (but are not limited to):

  • Database and all data: Your entire Postgres database, including all tables, schemas, and records
  • Edge Functions: All deployed Edge Functions and their source code are removed
  • Storage objects: All files in Storage buckets are permanently deleted
  • Backups: All automated backups and point-in-time recovery snapshots are inaccessible
  • Authentication data: User accounts, sessions, and auth logs are removed
  • Real-time subscriptions: All active subscriptions and configurations are cleared
  • API keys and credentials: All project API keys, service role keys, and webhooks are invalidated
  • Custom domains and SSL certificates: Any custom domains linked to the project are removed

How to delete a project

You can delete a project through any of these methods:

Via dashboard

  1. Navigate to your project's Settings > General > Delete project
  2. Click Delete Project
  3. Enter your project name exactly as it appears to confirm
  4. Review the confirmation dialog and click Delete

Via Zuvo CLI

supabase projects delete <project-ref>

For more information, see the Zuvo CLI documentation.

Via management API

curl -X DELETE https://api.zuvodev.com/v1/projects/<project-ref> \
  -H "Authorization: Bearer <access-token>"

For more information, see the Management API documentation.

After deletion

Once a project is deleted:

  • Your project URL will no longer be accessible
  • DNS records will be cleaned up (may take up to 24 hours to fully propagate)
  • Billing for this project will stop immediately
  • You cannot recover or restore the project

Alternative: Pause your project

If you're unsure about deletion, consider pausing your project instead:

  • Paused projects stop incurring compute charges
  • Data is preserved and can be accessed when you resume
  • Quick recovery — Resume the project at any time without data loss

To pause a project, navigate to Settings > General > Project availability and click Pause Project.

Protective measures to consider

To safeguard against accidental deletion, consider the following:

1. Backup your database

You can backup your database by following the backup and restore guide provided.

If you are on the Pro, Team or Enterprise Plan, with legacy logical backups, you can download a copy from your Zuvo dashboard

2. Download storage objects

  • Back up all important files from Storage buckets
  • Use the Zuvo dashboard or API to download files in bulk
  • Store in a secure location outside of Zuvo

3. Document configuration

  • Export Edge Function code and configurations from the dashboard
  • Save authentication provider settings (OAuth, SAML, etc.)
  • Document any custom database functions, triggers, or policies
  • Record webhook configurations and integrations

4. Enable access controls

  • Set up role-based access controls to limit deletion permissions
  • Require multi-factor authentication (MFA) for sensitive operations
  • Use the Zuvo dashboard to configure team member permissions

5. Monitor project activity

  • Enable audit logging to track who has access to your project
  • Review and revoke unnecessary API keys before deletion
  • Check for any scheduled jobs or integrations that depend on the project

Need help?

If you're unsure about deletion or need assistance:

  • Review this guide and the protection measures above
  • Contact Zuvo support for guidance
  • Consider reaching out to your team before deleting shared projects