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



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
Get the data

Retrieves a list of all users

for

of the specified tenant

with the name. Get users returns a list of users filtered by

. 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-tm/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
panel
yml
[{


  "id": "a69a0eb6-3662-4c00-8096-38fbb2c4a922",


  "email": "
bartonitz@optimal-systems
firstexample@exampleprovider.de"

,
  "
username
userName"
:
: "
bartonitz
mrexample",

,

  "firstName"
:
: "
Martin
Examplename",

,

  "lastName":
:
 "
Bartonitz
Examplesurname",


  "roles": ["role1","role2"],
  "groups": ["group3","group1"],


  "enabled": true,


  "createdTimestamp": 1555069963564


},


{


  "id": "
63d039b6
a69a0eb6-
71c4
3662-
49dc
4c00-
bf90
8096-
baa19acdbef9
38fbb2c4a933",


  "email": "
bartonitz@optimal-systems
secondexample@exampleprovider.de"
,
  "username":

  "userName": "msexample",
  "firstName": "
schulz
Examplename2",

,

  "lastName"
:
: "
Schulz
Examplesurname2",

,

  "
firstName
roles":
:
 ["role1","
Andreas
role2"],

  "roles

  "groups": ["
role3
group2","
role4
group1"],


  "enabled": true,


  "createdTimestamp":
1555069963564
 1555069963563
},


...]

{