Deletion & Deactivation

Deactivate a Sub-Account (API)

The DELETE /v1/sub-accounts/:id endpoint deactivates a sub-account immediately. All API keys are revoked and messaging stops.

TypeScriptcURLCopy
const result = await zavu.subAccounts.deactivate("jx7abc123def456");
console.log(`Keys revoked: ${result.keysRevoked}`);

Response:

JSONCopy
{
  "message": "Sub-account deactivated",
  "keysRevoked": 2
}

Delete a Sub-Account (Dashboard)

Permanent deletion is available from the Zavu dashboard and follows a 14-day grace period to prevent accidental data loss.

How It Works

1. Schedule deletion

   From the dashboard workspace switcher, select the sub-account and choose "Delete". This schedules deletion but does not remove any data yet.

2. API keys are revoked

   All API keys for the sub-account are revoked immediately. The sub-account can no longer send or receive messages.

3. Email notifications

   The team owner receives email notifications at multiple intervals:

   When	Email
   Day 0	Deletion scheduled notification
   Day 1	Reminder: 13 days remaining
   Day 7	Reminder: 7 days remaining
   Day 12	Urgent: 2 days remaining
   Day 14	Sub-account permanently deleted

4. Restore or wait

   During the 14-day grace period, you can restore the sub-account from the dashboard. After 14 days, all data is permanently deleted.

Restoring a Deleted Sub-Account

If you change your mind during the 14-day grace period:

1. Open the dashboard workspace switcher
2. Find the sub-account marked as "Pending Deletion"
3. Click "Restore"

The sub-account returns to active status. You'll need to create new API keys since the originals were revoked.

Deletion Rules

• You cannot delete the last active sub-account in a team. At least one project must remain active.
• The main account follows the same deletion rules as sub-accounts.
• Scheduled reminder emails are automatically cancelled if the sub-account is restored.

Deactivation vs Deletion

Next Steps