Managing a workspace

Create a workspace, manage the devices, data flows, and rules it holds, and configure the settings that apply to them.

Workspaces are where the actual work happens. Adding integration providers, data flows, and rules, or managing devices, are all activities that happen within a workspace. An organization can hold as many workspaces as you need, and every device belongs to exactly one of them.

The workspace home summarizes the state of the workspace: a health score with a short written assessment, the total device count, a breakdown of device status by online state, battery level, and signal quality, recent data processing, and the workspace metadata. Genio can analyze the same picture and suggest what to do about it.

For how workspaces sit between organizations and devices, see Workspace Context. For the level above, see Managing an organization.

Create a workspace

To create a new workspace, select Add workspace on the workspaces page in your organization, or when switching workspaces.

Create workspace

What you manage in a workspace

Devices

The asset inventory of this workspace, where devices are created, imported, and inspected.

Data Flows

How uplinks are authenticated, decoded, and where the results are stored or forwarded.

Rules

Business logic on incoming data, triggering notifications, downlinks, or aggregations.

Integrations

Connectivity provider accounts, used to connect, synchronize, and manage their devices.

Custom Fields

Your own structured information on devices, such as a serial number or GPS coordinates.

Tags

Groupings of devices, so that filters, dashboards, and rules can address them together.

Each of these lives in its own workspace, so devices, data flows, rules, and integrations in one workspace are invisible to another. Tags and custom fields are defined per workspace too, which is why a tag has to be unique only within the workspace that owns it.

Alongside them, the workspace navigation holds Logs for inspecting what happened to incoming data, Users for access, and General settings. Whether a given page is accessible to you depends on your user role.

Users and roles

A workspace has three roles: admin, editor, and viewer. Only workspace admins, and organization admins and owners, can invite users or change their roles. Every user listed on the workspace users tab shows both their organization and their workspace role.

Organization roles above member carry implicit access to all of that organization's workspaces, so a user can reach a workspace either directly or through the organization.

Users (Workspace)User Roles