To run various API requests with the skills involved you will need to know the ID of the skill in question and the ID of that skill's level. This article describes what API to use to get this data.
NOTE
We've implemented new Skills endpoints that will eventually replace the corresponding Competency endpoints. You can continue to use the legacy Competency endpoints until we deprecate them as part of the Learn365 (v.3.64) release, which is currently scheduled for Monday, August 18, 2025.
We advise you to start planning for the deprecation of the Competency endpoints and migrating to the new Skills endpoints. This is to ensure that, if you encounter any issues or errors, they can be resolved by the time we deprecate the endpoints.
This article describes how to get the ID of a skill via new, as well as legacy endpoints.
Get the IDs of a skill and its level via the UserSkills endpoint
1. Go to https://api.365.systems/ and make sure you are authorized with the relevant API key.
2. In the UserSkills section, select the GET /services/skills/UserSkills endpoint and select Try it out in the top right-hand corner.
3. Select Execute to run the command.
TIP
You can use the query options parameters to control the data in the response by setting filters.
4. 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, you will see the list of all the skills on the tenant.
- Copy the required SkillId and LevelId parameters.
- Select Download to save the results to your computer in JSON format.
Get the IDs of a skill and its level via the UserCompetencies endpoint (legacy)
1. Go to https://api.365.systems/ and make sure you are authorized with the relevant API key.
2. Find the UserCompetencies section, expand it, find the GET method /odata/v2/UserCompetencies with the Returns the list of user competencies (skills) owned by current user description and then select Try it out in the top right corner.
3. Select Execute to run the command.
TIP
You can set Competency, User for $expand so that the response will contain more details, including the name of the skill and the users it is granted. You can use other query options parameters to control the data in the response by setting filters.
4. 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, you will see the list of all the skills of the currently logged-in user.
- Search via Ctrl+F for the URL of a specific skill. In case Competency was set for $expand, you can user search to find the skill by its title. Copy its CompetencyID and LevelId parameters.
- You can use the Download option to save the results to your computer in JSON format.
Comments
Article is closed for comments.