Deactivate a Sub-Account (API)
TheDELETE /v1/sub-accounts/:id endpoint deactivates a sub-account immediately. All API keys are revoked and messaging stops.
Deactivation via the API sets the sub-account status to
inactive and revokes all API keys. This is not the same as permanent deletion.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
Schedule deletion
From the dashboard workspace switcher, select the sub-account and choose “Delete”. This schedules deletion but does not remove any data yet.
API keys are revoked
All API keys for the sub-account are revoked immediately. The sub-account can no longer send or receive messages.
Email notifications
The team owner receives email notifications at multiple intervals:
| When | |
|---|---|
| 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 |
Restoring a Deleted Sub-Account
If you change your mind during the 14-day grace period:- Open the dashboard workspace switcher
- Find the sub-account marked as “Pending Deletion”
- Click “Restore”
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
| Action | API Keys | Data | Reversible | Method |
|---|---|---|---|---|
| Deactivate (API) | Revoked | Preserved | Yes — set status to active | DELETE /v1/sub-accounts/:id |
| Delete (Dashboard) | Revoked | Removed after 14 days | Yes — within 14 days | Dashboard UI |