Docs
The PlatformConceptsRulesGlance mobile appDevice Rollout mobile app

In this article

Grounds

Grounds are distinct areas of the platform which group relevant IoT resources together, allowing for easier access management, delegation and separation of concerns.

A ground allows people with common interest to build and share their IoT devices, assets and data either internally within a team, externally to a selected audience or publicly with everyone. This enables better collaboration between people who are building and maintaining common IoT resources.

Your environment

You can organize your IoT product and applications within multiple usage contexts, for example projects, business units, customer segments, facilities, apartments, rooms, homes, common spaces, locations and so on…

Own and joined grounds

You are granted full access to manage all resources of a ground that you own, while you have limited access to the resources of grounds that you have joined as member.

Creating new ground

As a user, you can add new grounds to your environment, in order to clearly distinct one usage area from another. In order to create new ground, all you need is a valid name (title). The system will then create a public but unlisted ground.

Manage your ground

Changing ground title

You can modify the title of a ground that you own, so it better tells what’s behind it. Once you change it, the new title becomes available to everyone who is visiting your ground.

Allowing members to add and manage ground resources

As a ground owner, you can allow people in your ground to co-manage devices and rules together with you.

📘 Read more about Ground permissions

Deleting ground

You can delete any ground that you own, given you have previously removed all native devices from that ground.
Once the ground is deleted, none of the previous members will be able to access or revive it.

When you create a ground, it’s by default made public. Once you share the URL of the ground with another user that you trust, they will be able to view the ground name and pulse.

⚠️ If someone (usually an owner) has shared a public ground’s URL with you, you are able to view the ground’s title and pulse even you are not it’s member.

Manage members

People that collaborate with you in a ground are called members. A ground can have unlimited number of members.

Viewing members

Being a ground owner or member, you can view basic info (such as usernames) of all members of that ground.

Adding members

As a ground owner, you can add ground members by providing their username or email address.

  • If such email address is not associated with an existing account, system will send a personal invitation link by email. Recipient will therefore be able to complete their account credentials and become a regular user.
  • If user account with such email address already exist, system will add that user as ground member without sending any notification.

Removing members

As the ground owner, you can always decide to remove a member from the ground, so she doesn’t have the access to the ground resources.

Ground tokens

Ground tokens allow client applications to access multiple resources within a ground. Best example is a client that wants to access all devices and their assets within a single ground.

✉️ Let us know if you want to read more about how to use ground tokens. We are currently preparing a tutorial about it

Creating new ground token

When you create a new ground, a ground token is generated.
You can create unlimited number of ground tokens for each ground. By having multiple ground tokens, you can delegate and manage ground access for multiple client applications.

Viewing ground tokens

For each ground, you can view all the generated ground tokens.

Revoking ground token

After you revoke a ground token, system will prevent any access to ground resources to the clients that continue to present the revoked token.

Join ground as member

By default no one can join ground if not explicitly invited (or added) by the ground owner.
Specifically, when you create a ground that anyone can join, and share the ground’s URL with an audience, anyone with an account can join your ground and therefore become it’s member.