tenants
Delete Tenant
Delete tenant from the platform (PERMANENT).
Purpose: Remove a tenant/organization from the platform
What it does:
- Permanently deletes tenant account
- Used when customer cancels service
- Removes all tenant data from the system
⚠️ WARNING - CASCADE DELETE: This operation permanently deletes ALL related data:
- All agents created by this tenant
- Call history and recordings (all calls)
- Workflows and integrations (custom flows, API configs)
- Files and logs (knowledge base, activity logs)
- SIP trunks (phone number configurations)
- Squad configurations (agent teams)
Use Cases:
- Customer account cancellation
- Service termination
- Data cleanup after trial expiration
Recommended Practice:
- Export/backup tenant data before deletion
- Verify tenant has no active calls/sessions
- Notify customer before deletion
- Consider soft-delete (status=inactive) instead
Delete Tenant