Organization context

Where organizations sit in the akenza hierarchy, what belongs to one, and who can reach it.

Organizations are one level in the hierarchy of entities in the akenza ecosystem. Listed below is a hierarchically sorted list of entities:

• Tenant, the akenza deployment the organization runs on

• Organization

• Workspace

An organization on akenza is an entity to control access rights to workspaces, assets and data. Each organization contains one or more workspaces as well as one or more users.

Organizations extend over all applications of akenza. Any given organization will extend over all applications its subscription allows access to.

Billing and subscription are managed at organization level. See our Billing & Subscription page for details.

What belongs to an organization

An organization is the level at which access, identity, and anything shared between projects is decided:

Object	Scope
Workspaces	Every workspace is assigned to exactly one organization.
Devices	Belong to a workspace, but can be listed and searched across the whole organization.
Custom components	Custom device types and logic blocks are defined once here and usable in any workspace.
Dashboards	Managed at organization level, so one dashboard can combine devices from several workspaces.
Data Fusion Layer	The semantic model of sites, floors, zones, and assets.
API keys	Issued per organization and scoped to it.
Audit logs	A record of changes across the organization.
Users	Access is granted here or in an individual workspace.

The division is worth keeping in mind when deciding where to put something. Objects used in day-to-day operation of one project, such as devices, data flows, rules, integrations, tags, and custom fields, belong to a workspace. Anything shared between projects, or that concerns who may see them at all, belongs to the organization.

Managing an organization

Users in an organization

The following user roles exist in an organization:

• Organization owner

• Organization admin

• Organization editor

• Organization viewer

• Organization member

Refer to the user roles page for an overview of all user permissions for each role.

A user with access to at least one workspace in an organization will show up as organization member. A user with organization-specific rights higher than member has corresponding access rights to all workspaces of the organization, including workspaces created later. Access granted in a single workspace never extends upward to the organization.

Only the organization owner can delete the organization or transfer ownership, and an organization has exactly one owner at a time.

Organization settings

Each organization carries its own settings, including white labeling, whether Genio AI is active, and its subscription. Because subscription is held here, workspaces inherit the features available to them from the organization they belong to.

General Settings

Usage examples

Organizations on akenza often reflect business organizations, companies or organization units.

Resellers of the akenza platform may choose to onboard their customers as organizations on their tenant, strictly isolating the devices and data of individual customers. Combined with white labeling, each customer sees a platform carrying the reseller's branding rather than akenza's, and a tenant integration lets them all onboard devices onto the reseller's own network.