Skip to main content

Platform Hierarchy

DialStack uses a multi-tenant architecture with a clear hierarchy. Understanding this structure helps you organize and manage your resources effectively.

Data Model​

Platform
├── Account
│   ├── User
│   │   └── Endpoint (SIP line)
│   ├── Phone Number (DID)
│   ├── Location
│   └── DECT Base Station
│       └── Handset
└── Platform Admin

Hierarchy Levels​

Platform​

The top-level tenant. Each platform operates independently with its own:

  • Branding and custom domain
  • API keys (publishable and secret)
  • Webhook configuration
  • One or more accounts

Account​

A business unit or organization within a platform. Each account has:

  • Its own set of users and devices
  • Phone number assignments
  • Physical locations
  • Device registrations (desk phones, DECT base stations and handsets)
  • Independent extension numbering

User​

A person within an account who makes and receives calls. Each user can have:

  • One or more registered devices (desk phones, softphones, WebRTC clients)
  • Voicemail
  • Call history

Role Hierarchy​

RoleAccess Level
Super AdminAll platforms and accounts, system-wide settings
Platform AdminAll accounts within their platform, platform settings and branding
Account AdminUsers, devices, phone numbers, and locations within their assigned accounts

Higher roles inherit all capabilities of lower roles. A super admin can do everything a platform admin or account admin can do.