The Manage Tenants view provides a list of tenants with description and status information for each tenant. With the appropriate permissions, you can add, modify, and delete tenants using this view.

The Manage Tenants view is available to users with either set of the following permissions.

  • Administrator (12) permission
  • WebUI (8) and TenantAPI (25) permissions, and administrative access on tenants the user administers
manage tenants view

The following table provides permissions and descriptions for each action in the Manage Tenants view.

Note: Any user with Administrator (12) permission may perform all actions.
Action Permissions Description

Create new tenant

WebUI (8)

TenantAPI (25)

To create a new tenant, click + New Tenant. Define the tenant with settings under each of the following tabs.

  • General tab. Enter values in the given fields. The tenant name is required.
  • Roles tab. Import roles from the parent tenant, if desired.
  • Limits tab. Set limits as desired.

Edit a tenant

Administrative access for the tenant

WebUI (8)

TenantAPI (25)

To edit a tenant, select a tenant from the list of tenants. Then, select Edit from the Actions dropdown. Edit the tenant settings as desired.

Delete a tenant

Administrative access for the tenant

WebUI (8)

TenantAPI (25)

To delete a tenant, select the tenant you want to delete. Then, select Delete from the Actions dropdown. Confirm or cancel the delete operation in the dialog.

View tenant users

Administrative access for the tenant

WebUI (8)

ViewUsers (14)

TenantAPI (25)

To view the users of a tenant, select the tenant from the list of tenants. Then, select View Users from the Actions dropdown. You are directed to the Manage Users view where a list of users belonging to the tenant is displayed. See Manage Users view for details.

Transfer tenant users

Administrative access for the system tenant and the tenant to which user(s) will be transferred

WebUI (8)

ViewUsers (14)

ModifyUsers (15)

TenantAPI (25)

To transfer users from the system tenant to a child tenant, select the child tenant from the list of tenants. Then, select Transfer Users from the Actions dropdown. You are directed to the Transfer User From System Tenant page. Select each user you want to transfer to the child tenant, and choose a role for each user from the role dropdown.

Note: Users can only be transferred from the system tenant to a child tenant.