Skip to content

Device ownership

Note

We're sorry, this article hasn't been completed or updated yet. We're working on finishing it as soon as possible. If you have a question, please reach out to our Support Team.

The Kontakt.io API provides our customers with a way to easily keep track of their Kontakt.io devices.

To take full advantage of the Kontakt.io platform, one of the first steps is to understand how devices are assigned to a Kio Cloud account (required), how to move them to different (sub-)accounts, and how to share access to them with others.

Add devices to Kio Cloud

When you make a purchase from the Kontakt.io Web Store or through our Sales Team, they are bundled under a single Order ID - all devices purchased at the same time share it.

The Order ID is used to add devices to Kio Cloud. To learn how, see Add Devices.

Warning

An Order ID is a one-time-use code. When entered into Kio Cloud or used via the API, it can't be used again.

There is, however, an API endpoint just for that - POST /order/assign:

POST /order/assign HTTP/1.1
Accept: application/vnd.com.kontakt+json;version=10
Api-Key: yourSuperSecretAPIKey
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: api.kontakt.io
Connection: close
User-Agent: Paw/3.1.4 (Macintosh; OS X/10.13.2) GCDHTTPRequest
Content-Length: 23

orderId=aaabbb%2C123dfg

It will automatically add all devices from specified orders to the account from where the API Key has come from.

Moving devices

After assigning devices from a new order to an account, the manager of the account becomes an OWNER of these beacons. OWNER has full access to beacons, can change all parameters on them, asl well as move them to different accounts. However, when it come to moving, there are some differences in the process, depending on the relation between the OWNER account and an account that should receive some devices.

Note

Before proceeding, please make sure you understand how does the account structure looks like on Kontakt.io backend.

Within a company

If a manager is an OWNER or has a SUPERVISOR type of access to a device,

Outside a company

POST /device/move HTTP/1.1
Accept: application/vnd.com.kontakt+json;version=10
Api-Key: yourSuperSecretAPIKey
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: api.kontakt.io
Connection: close
User-Agent: Paw/3.1.4 (Macintosh; OS X/10.13.3) GCDHTTPRequest
Content-Length: 48

uniqueId=U4OP&managerEmail=username%40domain.tld

Sharing devices

POST /device/share HTTP/1.1
Accept: application/vnd.com.kontakt+json;version=10
Api-Key: yourSuperSecretAPIKey
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: api.kontakt.io
Connection: close
User-Agent: Paw/3.1.4 (Macintosh; OS X/10.13.3) GCDHTTPRequest
Content-Length: 110

uniqueId=1nau&managerMail=marty.mchack%40kontakt.io&access=EDITOR&expirationDate=1516876204&withMetadata=true