Skip to main content
View Markdown

Delete Application

The delete command permanently deletes your ZeyOS application from the current instance.

Bash
zeysdk delete [options]

Options

OptionDescription
-f, --forceSkip deletion confirmation prompt
--verboseShow detailed output

Process

  1. Validation

    • Checks that the command runs inside a linked app
    • Loads .zeysdk/sync.json
    • Verifies required instance and app identifiers
  2. Confirmation

    • Prompts before deleting the remote application
    • Stops when deletion is not confirmed
    • Uses verbose output for additional progress details
  3. Deletion

    • Sends the delete request to the current instance
    • Removes the application from the platform
    • Reports the final deletion result

Examples

Bash
zeysdk delete
zeysdk delete --force
zeysdk delete --verbose

Error Handling

ErrorDescriptionResolution
Missing sync.jsonsync.json file not foundEnsure you are in an app directory
Invalid sync.jsonMissing required keysVerify sync.json has id and url
API errorServer communication failedCheck connection and permissions

Warning

Delete permanently removes the application from the current instance.

Notes

  • Delete acts on the currently linked instance
  • Local files are not a substitute for a remote backup
  • Use zeysdk whoami before deleting if you are unsure which instance is active
  • Consider zeysdk predelete when you need a reversible operational state first
  • --force skips confirmation and should be used carefully

Best Practices

  • Create a snapshot before destructive changes
  • Confirm the active instance before deleting
  • Notify affected users before removing production apps
  • Keep a record of the app ID and instance for audit purposes