Organizations, projects and environments
How to create organizations and projects in the dashboard and switch between the live and test environments, plus renaming organizations and projects and deleting projects.
Everything in voicast sits in three levels: organization › project › environment.
| Level | What it is | What it separates |
|---|---|---|
| Organization | Your company or team | Members and roles, billing (balance and top-ups) |
| Project | A service within the organization. Up to 20 per organization | A pair of live and test environments |
| Environment | Live and test | Agents, tenants, call records, connections, API keys, webhooks |
An environment's content can't be seen from other environments. Try things out in the test environment so they stay separate from live records. Test calls cost the same as live calls (Pricing and billing).
Create an organization#
The first time you sign in, the Create an organization page opens. After that, choose + New organization in the switcher at the top of the left menu.
- Enter your company or team name under Organization name (up to 100 characters). It also appears on invoices.
- Enter a name such as your service name under First project name (up to 100 characters).
- Press Create organization.
You become the organization's owner, and the first project with its live and test environments is created. You can change the organization name later on the Organization tab of Settings (see Rename the organization).
Switch#
Press the button at the top of the left menu (the organization name and "Project: … · Live environment") to open the switcher.
| Heading | What you choose |
|---|---|
| Organization | Organizations you belong to (with your role) |
| Projects | Projects in the current organization |
| Environment | Live (vk_live_) or test (vk_test_) |
Switching projects or environments keeps you on the same kind of page (agents, call log and so on). The top bar shows where you are as organization › project › environment.
Create a project#
Requires the admin role or above.
- Choose + New project in the switcher.
- Enter a project name (up to 100 characters) and press Create.
The new project's live environment opens. Each project has a live and a test environment.
Rename a project#
Requires the admin role or above.
- With the project open, choose Rename project in the switcher.
- Enter the new name and press Save.
Delete a project#
Requires the admin role or above. This can't be undone.
- With the project open, choose Delete project in the switcher.
- To confirm, type the project name and press Remove.
All agents, tenants, call records, recordings, connections, API keys and webhook endpoints in its live and test environments are deleted. See Deleting data.
Organization settings#
Settings in the left menu has these tabs.
| Tab | What | Who can open it |
|---|---|---|
| Account | Your name, passkeys and connected apps (Sign-in and account) | Everyone |
| Members | Invitations and roles (Members and roles) | Everyone (changes need admin or above) |
| Billing | Balance, top-ups and invoices (Top-ups and billing) | Admin and above |
| Organization | Renaming the organization, its ID, and deleting the organization | Owners |
Rename the organization#
Requires the owner role.
- Open the Organization tab of Settings.
- Enter the new name under Name (up to 100 characters) and press Save.
The organization name is also the addressee on invoices and receipts. A change applies to invoices and receipts issued from now on; ones already issued keep the old name.
Delete the organization#
To delete the organization, press Delete organization on the Organization tab, type the organization name and press Remove. The balance is not refunded (Deleting data).