Endpunkte

• GET /users/{userId}/managing-groups- listet auf, welche Gruppen ein Manager verwaltet
• GET /groups/{groupId}/managers- listet die Manager einer Gruppe auf

Listet Gruppen auf, die ein Manager verwaltet

GET /users/{userId}/managing-groups

Anforderungsparameter (Abfragezeichenfolge)

• limit(Ganzzahl, optional) — die maximale Anzahl von Ergebnissen, die in einer einzigen Antwort zurückgegeben werden können (siehe Paginierung); muss zwischen 1 und 100 liegen (standardmäßig 50)

Beispiel für eine Antwort

{
  "userUrl": "<https://api.rise.com/users/example-user-id-1>",
  "groups": [
    {
      "id": "example-group-id-1",
      "membersUrl": "<https://api.rise.com/groups/example-group-id-1/users>",
      "managersUrl": "<https://api.rise.com/groups/example-group-id-1/managers>",
      "reportersUrl": "<https://api.rise.com/groups/example-group-id-1/reporters>",
      "name": "Example Group",
      "url": "<https://api.rise.com/groups/example-group-id-1>"
    }, ...
  ],
  "nextUrl": "<https://url-for-next-page-of-results>"
}

Endpunktspezifische Fehlercodes:

• user_not_found- Die Gruppen des Managers können nicht aufgelistet werden, da der Benutzer nicht existiert
• invalid_user_role- kann die Gruppen des Managers nicht auflisten, da der Benutzer kein Manager ist

Die Manager einer Gruppe auflisten

GET /groups/{groupId}/managers

Anforderungsparameter (Abfragezeichenfolge)

• limit(Ganzzahl, optional) — die maximale Anzahl von Ergebnissen, die in einer einzigen Antwort zurückgegeben werden können (siehe Paginierung); muss zwischen 1 und 100 liegen (standardmäßig 50)

Beispiel für eine Antwort

{
  "groupUrl": "<http://api.rise.com/groups/example-group-id>",
  "managers": [
    {
      "id": "example-user-id-1",
      "email": "foo@example.com",
      "groupsUrl": "<https://api.rise.com/users/example-user-id-1/groups>",
      "managingGroupsUrl": "<https://api.rise.com/users/example-user-id-1/managing-groups>",
      "reportingGroupsUrl": null,
      "role" :"manager",
      "firstName": "Example Group Manager",
      "lastName": "Example Last Name",
      "lastActiveAt": "2021-10-28T20:39:52.659Z",
      "learnerReportUrl": "<https://api.rise.com/reports/learners/example-user-id-1>",
      "url": "<https://api.rise.com/users/example-user-id-1>"
    },
    {
      "id": "example-user-id-2",
      "email": "bar@example.com",
      "groupsUrl": "<https://api.rise.com/users/example-user-id-2/groups>",
      "managingGroupsUrl": "<https://api.rise.com/users/example-user-id-2/managing-groups>",
			"reportingGroupsUrl": null,
      "role": "manager",
      "firstName": "Example Group Manager 2",
      "lastName": "Example Last Name",
      "lastActiveAt": "2021-10-28T20:39:52.659Z",
      "learnerReportUrl": "<https://api.rise.com/reports/learners/example-user-id-2>",
      "url": "<https://api.rise.com/users/example-user-id-2>"
    }, ...
  ],
  "nextUrl": "<https://url-for-next-page-of-results>"
}

Endpunktspezifische Fehlercodes:

• group_not_found- Manager können nicht aufgelistet werden, da die Gruppe nicht existiert