Revoking user's skills via API

Among the API commands there are those that allow to revoke users' acquired skills.

This article describes how to do it in LMS365 via API.

NOTE   

Skill is named Competency in some of the API sections and commands.

 

To revoke a user's skill via API, follow the steps:

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

2) Find the 'Users' section, expand it, find the POST /odata/v2/Users('{LoginName}')/RevokeCompetency

To be able to revoke user's skill you will need to insert user's LoginName, and skill's CompetencyID and LevelID in the fields for the system to know what exact skill to revoke from what user.

 

 

3) To find user's LoginName, go to the 'Users' section, expand it, find the GET /odata/v2/Users and click 'Try it out'. Select the Execute button to run the command.

Go to the Responses block to check the results:

  • Number 2xx (for example, 200) under Code shows that the request worked correctly.
  • In the Response body field search via Ctrl+F  for the relevant user and can copy the data next to "LoginName".

 

 

Paste the data in the key:LoginName field of the POST /odata/v2/Users('{LoginName}')/RevokeCompetency.

 

 

4) To find the CompetencyID and LevelID of the skill you want to revoke from the user, go to the 'UserCompetencies' section, expand it, find the GET /odata/v2/UserCompetencies and click 'Try it out'. Select the Execute button to run the command. 

 

 

Go to the Responses block to check the results:

  • Number 2xx (for example, 200) under Code shows that the request worked correctly.
  • In the Response body field search via Ctrl+F for the relevant skill and copy the data next to "CompetencyId" and "LevelId".

 

In the Edit Value field of the POST /odata/v2/Users('{LoginName}')/RevokeCompetency replace the word 'string' with the corresponding data for "CompetencyId" and "LevelId" respectively.

 

 

5) When ready, click the Execute button to run the command. The skill of the user is now revoked. The user will receive LMS365 notification(s) that the skill of a certain level is revoked. 

 

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

Comments

Article is closed for comments.