Skip to content

Account structure

In order to take full advantage of Kontakt.io devices, they have to be associated with a Manager account. The simplest way to get a Manager account is to create one fromKio Cloud. To avoid any surprises in the future, it's important to fully understand what exactly happens when someone creates an account and how the accounts structure looks like on the Kontakt.io backend.

Note

The terms Account and Manager are used interchangeably in this article.

Company

The first thing to understand after creating a new account in Kio Cloud, is that the Kio Cloud backend automatically creates a group called Company and associates the newly created Manager with it. If you were to ask our API for information about your Manager, you would see in the response information about the Company:

{
  "firstName": "John",
  "lastName": "Smith",
  "companyId": "52087478-3d20-4fa2-9658-87b58df046bd",
  "role": "SUPERUSER",
  "counters": {
    "devices": {
      "private": 19,
      "public": 0,
      "shared": 1,
      "sharedWithMe": 0
    },
    "venues": {
      "private": 7,
      "public": 0,
      "shared": 0,
      "sharedWithMe": 0
    }
  },
  "company": {
    "subscriptionPlans": [
      "LOCATION_ENGINE",
      "MANAGEMENT"
    ],
    "countryCode": null,
    "name": "Kontakt.io",
    "id": "52087478-3d20-4fa2-9658-87b58df046bd",
    "paidFeatures": [],
    "uniqueId": "DpFcLq"
  },
  "id": "4a23bb48-31c0-4f59-938e-d00a3a8c0186",
  "supervisorId": null,
  "email": "j.smith@kontakt.io",
  "uniqueId": "EN4sYm"
}

Manager roles

Creating an additional structure like the Company makes only sense if it can hold more than a single Manager. That's why we allow creating multiple Managers within a Company with different access to devices.

Important

Each of the accounts belonging to a Company has exactly the same set of features. The only differences between them is whether they can create additional Managers and to what devices they have access to.

Apart from having their own Kio Cloud login credentials, each Account has its own API Key.

Superuser

Each Company can have only one Superuser. This type of privilege is automatically granted to who created the Kio Cloud account. Once the account is activated and the Manager logs in to Kio Cloud, they can create additional sub-accounts within the Company. These accounts can be of one the two types: Admin or Operator.

Warning

Within the Kio Cloud backend, Accounts of any type are uniquely identifiable by their email addresses. If you create an Account with one email address, it can't be used elsewhere, even as a sub-account within a different Company.

A Superuser account can't be deleted. This role also cannot be reassigned to a different Manager within Company.

Admin

An Admin, just like any other Manager types, has access to all Kio Cloud features. An Admin can create their own sub-Managers, but only with Operator privileges.

Operator

An Operator has full access to management functionality offered by Kio Cloud. They cannot create sub-Accounts.

Hierarchy - Supervisors and Subordinates

A Superuser is a Supervisor to all other sub-Accounts within the Company.

The Admins are the subordinates of the Superuser, but they can be Supervisors to Operators.

Operators, on the other hand, can only be subordinates. It's important to understand that only the Superuser or Admin that created the Operator can be Supervisors of that Account.

Access to devices

The reason for such a complex Account structure is to allow different users to access the same beacons. Each Supervisor can modify configurations of the beacons belonging to their Account, as well as devices assigned to their Subordinates.