Skip to Content
IDMUsers with Access

Active Users of an App

Eduplaces differentiates between users and people. Which people are available are configured explicitly by the school, whereas users are defined to have access to the app, i.e. they can perform single-sign on with the app.

You can use the users endpoints to update your user’s properties.

Eduplaces API

GET /schools/:id/users

PathAuthenticationRequired Scope
/idm/ep/v1/schools/:id/usersAccess Token in the apps context (Client Credentials)urn:eduplaces:idm:v1:users:read

Provides a list of users of a specific school.

HTTP/1.1 200 Content-Type: application/json [ { "id": "1d020d46-57c8-4be5-9423-b10e3e6f85e7", "name": { "firstFull": "Maximilian", "firstCall": "Max", "last": "Mustermann" }, "status": "ACTIVE", "role": "STUDENT", "groups": [ { "id": "2cf2f091-c545-473d-99c7-7a854243d0d3", "name": "Klasse 10a", "status": "ACTIVE" } ] } ]

GET /users/:id

PathAuthenticationRequired Scope
/idm/ep/v1/users/:idAccess Token in the apps context (Client Credentials)urn:eduplaces:idm:v1:users:read

Gets a specific user by its ID.

HTTP/1.1 200 Content-Type: application/json { "id": "1d020d46-57c8-4be5-9423-b10e3e6f85e7", "name": { "firstFull": "Maximilian", "firstCall": "Max", "last": "Mustermann" }, "status": "ACTIVE", "role": "STUDENT", "groups": [ { "id": "2cf2f091-c545-473d-99c7-7a854243d0d3", "name": "Klasse 10a", "status": "ACTIVE" } ] }

This endpoint provides no information about the user’s access to your app. It returns all users that signed in to your app at least once without checking if they still have access. You should assume that a user can return to your app at any time, as long as you do not receive a 404 Not Found status for that user.

Receiving “404 Not Found: User not found”?
This means that the user does not exist or was deleted forever. If you have any data related to this user, you should remove it from your app as the user is no longer retrievable. In contrast, if the field status is set to SOFT_DELETED, the user was deleted but not irretrievable. In this case you should not remove any data related to this user from your app, as the user might be restored and return to your app later.