Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Page Properties
hiddentrue
idrDOC

Product Version
Report Note
AssigneeMartin

Resources & Remarks

  • Version 2.4 - options" ...  "synchronousContentAnalysis": true (OKTO-4309)

Modification History

NameDateProduct VersionAction
Antje08 FEB 20212.4New page properties macro.
Antje15 FEB 20212020 WinterrDOC
Antje04 JUN 20212021 Autumngroups parameter added to example

Martin: zu ergänzen: Mit 2021 Autumn Alpha1 werden auch die Gruppen gelistet, in denen ein Benutzer Mitglied ist.



As of Versionproduct version 2020 Winter | component version 1.0
Request MethodGET
Response FormatJSON
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.  
Planned for 2021 Autumn: Filter As 2021 Autumn, the list can be filtered by applying query parameters.


Required user role: YUUVIS_TENANT_ADMINAs of version 2021 Autumn, the following query parameters can be specified optionally:

ParameterTypeDescription
searchstringReturn only users where at least one of the properties userName, email, firstName or lastName contains the specified value.
firstintegerSkip the first users in the result list. Return only users with index equal or larger than the specified value.
maxintegerReturn only the specified number of users.
Meaning of the response status codes:


HTTP Status CodeMeaning
200 OKSuccessful, the data of all users of the specified tenant have been read.
401 UNAUTHORIZEDThe 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
languageyml
[{
  "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","group7group1"],
  "enabled": true,
  "createdTimestamp": 1555069963563
},

...]

{

...