With the Learn365 API, you can remove a user or a group from a course catalog.
This article describes how to use an API endpoint to delete a user or a Microsoft Entra (Azure Active Directory) group from a course catalog via the Learn365 API.
TIP
- The users added to a course catalog directly via the Learn365 Admin Center functionality (not via a Microsoft Entra group) can be deleted via the Learn365 Admin Center as well.
- You can remove users from the Microsoft Entra group via the Microsoft 365 Admin Center or remove the entire Microsoft Entra group via the Microsoft 365 Admin Center.
To delete a user or a Microsoft Entra group from a course catalog using API, follow the steps:
To be able to use the Learn365 API, you should be authorized with the relevant API key on https:/api.365.systems. For details, see this article.
1. In https:/api.365.systems, expand the CourseCatalogs section.
2. Select the DELETE /odata/v2/CourseCatalogs({id})/Users('{userLogin}') endpoint that removes a user from a course catalog and select Try it out.
3. In the opened Parameters section, complete the required query parameter fields:
- In the Course catalog id, enter the ID of the course catalog you want to remove a user or a group from.
- In the User login, enter the login name of the user or a group you want to remove from a course catalog.
4. Select the Execute button to run the request.
5. In the Responses block, check the results:
- Under Code, number 2xx (for example, 204) shows that the request worked correctly.
- In the Response body field, you will see the results of the request. The user/group will be deleted from the course catalog and from its Users list and will be unenrolled from all courses and training plans of this course catalog.
IMPORTANT
If a user is enrolled in any course or training plan of the course catalog via any other group, this user will remain in the Users list marked as not added to the course catalog . In this case, you need to remove the user from that group or remove that entire group to delete the user from the course catalog. For details, see this article.
Comments
Article is closed for comments.