Purge skills via API

It’s possible to purge a skill from the LMS365 (Learn365) tenant via API, therefore completely removing the skill information.

This article describes the steps you should follow to purge a skill via API.

 

NOTE   

  • You can purge both valid and revoked skills.
  • Purging one skill in a multi-level skill chain purges the entire chain.

 

Before purging a skill, you’ll need the:

  • LoginName of the user whose skill you want to purge. You can find it via the API by following the steps in this article.
  • competencyId. This is the ID of the skill you want to purge. You can find it via the API by following the steps in this article.

To purge a skill via the API:

1. Go to https://api.365.systems/ and make sure you are authorized with the relevant API key.

2. In the Users section, select the POST /odata/v2/Users(‘{LoginName}’)/PurgeCompetency endpoint and select Try it out in the top right-hand corner.

 

Purge a skill endpoint

 

3. Enter the LoginName and competencyId.

 

Purge a skill request

 

4. Select Execute to run the request.

5. Go to the Response block to check the results:

  • 202 code without parameters in its body means the successful response.
  • In case of an error, the response body contains the error object with the code and message keys explaining the issue.

You can check the Audit Trail to see more information about the purged skill.

6. Go to the LMS365 (Learn365) Admin Center > Global Settings > Audit Trail.

7. Find and select the last record with the Learner skill level was purged activity name to see more information.

 

Purge a skill audit trail

You can find more information about the Audit Trail in this article.

Was this article helpful?
0 out of 0 found this helpful

Comments

Article is closed for comments.