Skip to content

Tenant Management Service


Tenant Management is a central service within the MindSphere platform that provides the possibility to manage a tenant, its related subtenants as well as related data.



A tenant is an organization-specific logical environment for your data. A tenant typically represents a legal entity, such as a company or corporation. In this context MindSphere is a multi-tenant architecture.


A subtenant is an organization-specific logical environment for the data of a cooperating legal entity. A subtenant typically represents a subset of the tenant's data which the tenant wants to share with one of its customer represented within the subtenant.

Tenant information of a tenant

Within the tenant information the following parameters will be defined:

  • country
    The home base of your legal entity
  • displayName
    The brand name which is shown in the MindSphere environment.
  • name
    The name which is shown in the URL of the tenant.
  • prefix
    An ID which is used by developers to identify relevant code components.
  • type
    The tenant type: USER, DEVELOPER or OPERATOR

Via the legal tenant information the tenant can display its own legal/branding information sorted and ordered by languages and regions. If set, there is always a global region with a default language which is set to English. More regions can be defined and country codes can be added to them. One country can always belong to one region only, but a region can have many countries. Different languages can be set to a region and languages can be reused in different regions. A language can have many legal links which can be set as name-value pairs. A legal link can have different types such as www, phone and mail.

These legal links will be displayed in the UI depending on the tenant's country and the language settings of the web browser. The legal information is visible between two different tenants and the region settings of one tenant described above will ensure that the right information will be shown depending on the other tenant's country information.


The Tenant Management Service exposes its API for realizing the following tasks:

  • Retrieve tenant-specific information.
  • Manage your own legal information.
  • Create, retrieve and delete subtenants.

Example Scenario

The administrator of a machine manufacturer wants to update the original Siemens legal information of the tenant with the own relevant legal information of the legal entity in order to provide this information to other tenants and subtenants.

For details see Create your provider information.

Creating subtenants

The administrator of a machine manufacturer wants to create a subtenant for one of their customers in order to share some relevant machine data with this customer.

For details see Use the Tenant Management API to create a Subtenant.

Any questions left?

Ask the community

Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.