Skip to main content
A Ringg Space family is one primary workspace with any number of Ringg Spaces under it, typically one per client, brand, or team. Each Ringg Space is a full workspace with its own assistants, numbers, campaigns, call history, API key, and members, fully isolated from its siblings. The primary is the management console: it holds the family’s money and calling capacity, shares them out, and sees every Ringg Space’s data in one place. The primary itself does not place calls.
Ringg Spaces are enabled per customer. If the endpoints below return 403 Sub-workspaces are not enabled for this workspace., contact Ringg support to turn the feature on for your primary workspace.

​
Billing modes

The family’s billing mode is set when it is created and applies to every Ringg Space. Concurrency (how many calls can run at once) is bought on the primary and allocated to Ringg Spaces in both modes. In an individual family each allocation is that Ringg Space’s hard ceiling. In a common family idle capacity flows to whichever Ringg Space is busy, so a Ringg Space’s ceiling is the family total.

​
Authentication

Call every endpoint in this section with the primary workspace’s API key in X-API-KEY. The key identifies the family; there is no workspace header to set.
A Ringg Space’s API key cannot manage the family. Using one returns 400 Sub-workspaces cannot have their own sub-workspaces.

​
Endpoints

​
Money formats

The read endpoints and the concurrency endpoint return amounts as JSON numbers (200000.0). The two allocation endpoints return amounts as decimal strings ("200000.00"). Parse both before doing arithmetic.

​
Create an assistant inside a Ringg Space

There is no separate endpoint for this. A Ringg Space is a normal workspace, so use its own API key with the existing create assistant endpoint and the assistant is created inside that Ringg Space, invisible from the primary and from sibling Ringg Spaces. The same applies to every other endpoint in this reference: numbers, campaigns, calls, and history all scope to the workspace that owns the key. A new Ringg Space starts without an API key. To get one, switch into the Ringg Space in the Ringg AI dashboard, open Settings → API Key, and generate it there. The key is shown once, exactly as described in Authentication. Keys cannot be created or rotated through the API.

​
Typical flow

  1. Create the Ringg Space with the primary’s key.
  2. Allocate concurrency to it, and a credit limit or balance in an individual family.
  3. Generate the Ringg Space’s API key in the dashboard.
  4. Create assistants, attach numbers, and run campaigns with the Ringg Space’s key.
  5. Watch usage across the family with Get Ringg Spaces.