Endpoints for System Integrators

These endpoints can be used with the role YUUVIS_SYSTEM_INTEGRATOR for role, group and user management for a tenant and to create and delete tenants.

HTTP Method
as of product version
PurposeResponse FormatDescription

Manage Tenant Creation Profile

GET
2020 Winter
Retrieve the Keycloak System SettingsJSON

Retrieves the top-level representation of the identity provider Keycloak.
/tenant-management/api/system/info

POST
2020 Winter
Update the ProfileHTTP status code

Updates the tenant creation profile that is used while creating a tenant of a customer with all the information that should be set up, e.g., additional roles, users, schema and client settings. Each SaaS application has its own tenant creation profile.
/tenant-management/api/system/profile

GET
2020 Winter
Retrieve the ProfileJSON

Retrieves the profile data to be used when creating new tenants. Reads the tenant creation profile.
/tenant-management/api/system/profile


Manage Tenants

POST
2020 Winter
Create a TenantHTTP status code

Creates a new tenant with the values for the corresponding parameters specified in JSON format. Required settings for Keycloak and yuuvis® Momentum core are passed as well as custom (= product application) settings. 
/tenant-management/api/system/tenants

GET
2020 Winter
Retrieve the Data of all TenantsJSON

Retrieves the top-level representation of all realms. It will not include nested information like User and Client representations. Reads the list of all tenants. 
/tenant-management/api/system/tenants

GET
2020 Winter
Retrieve the Tenant data JSON

Retrieves the top-level representation of the Keycloak realm specified by tenant. It will not include nested information like User and Client representations. Reads the tenant data of the specified tenant
/tenant-management/api/system/tenants/{tenant}

DELETE
2020 Winter
Delete TenantJSON
GET
2020 Winter
Retrieve Metrics of a TenantJSON

Retrieves the current metrics of the specified tenant
/tenant-management/api/system/tenants/{tenant}/metrics

GET
2020 Winter

Request a List of RolesJSON

Gets all roles of the specified tenant
/tenant-management/api/system/tenants/{tenant}/roles

GET
2020 Winter

Request a List of UsersJSON

Retrieves a list of all users of the specified tenant. As 2021 Autumn, the list can be filtered by applying query parameters.
/tenant-management/api/system/tenants/{tenant}/users

POST
2020 Winter
Create  a UserJSON

Creates a new user with the given properties for the specified tenant.
/tenant-management/api/system/tenants/{tenant}/users

GET
2020 Winter
Retrieve the Data of a UserJSON

Retrieves the data of the user specified by tenant and id.
/tenant-management/api/system/tenants/{tenant}/users/{id}

PUT
2020 Winter
Update the Data of a UserHTTP status code

Update the data of the user specified by tenant and id.
/tenant-management/api/system/tenants/{tenant}/users/{id}

DELETE
2020 Winter
Delete a UserHTTP status code

Deletes the specified user of the specified tenant.
/tenant-management/api/system/tenants/{tenant}/users/{id}

GET
2020 Winter
Retrieve the Number of UsersTXT

Retrieves the number of all users of the specified tenant
/tenant-management/api/system/tenants/{tenant}/users/count