Page Comparison

...

As of Version product version 2020 Winter | component version 1.0

Request Method GET

Response Format JSON

Required Permission

Available if listed in authorization.accesses in authentication-prod.yml and the specified access condition is matched. In the default configuration, access is granted via the YUUVIS_SYSTEM_INTEGRATOR role.

>> AUTHENTICATION Service

Description

Excerpt
Retrieves a list of all users of the specified `tenant`. As 2021 Autumn, the list can be filtered by applying query parameters.

As of version 2021 Autumn, the following query parameters can be specified optionally:

Parameter	Type	Description
`search`	string	Return only users where at least one of the properties `userName`, `email`, `firstName` or `lastName` contains the specified value.
`first`	integer	Skip the first users in the result list. Return only users with index equal or larger than the specified value.
`max`	integer	Return only the specified number of users.

Required user role: YUUVIS_TENANT_ADMIN

Meaning of the response status codes:

HTTP Status Code	Meaning
`200 OK`	Successful, the data of all users of the specified tenant have been read.
`401 UNAUTHORIZED`	The call was unauthorized.

Request Example

GET /tenant-management/api/system/tenants/myTenant/users HTTP/1.1

GET /tenant-management/api/system/tenants/myTenant/users?first=1&max=5&search=test

Response Example

Code Block

language	yml

[{
  "id": "a69a0eb6-3662-4c00-8096-38fbb2c4a922",
  "email": "firstexample@exampleprovider.de",
  "userName": "mrexample",
  "firstName": "Examplename",
  "lastName": "Examplesurname",
  "roles": ["role1","role2"],
  "groups": ["group3","group1"],
  "enabled": true,
  "createdTimestamp": 1555069963564
},
{
  "id": "a69a0eb6-3662-4c00-8096-38fbb2c4a933",
  "email": "secondexample@exampleprovider.de"
  "userName": "msexample",
  "firstName": "Examplename2",
  "lastName": "Examplesurname2",
  "roles": ["role1","role2"],
  "groups": ["group2","group1"],
  "enabled": true,
  "createdTimestamp": 1555069963563
},

...]

{

...

Versions Compared

Old Version 18

New Version 19

Key