Skills
API endpoints related to the Skills Matrix
GET /skills/teams/:teamid/courses
Returns a list of all courses directly assigned to the team, along with the team's average skill rating for each course.
POST /skills/teams/:teamid/courses/details
Returns a list of objects for each course id sent in the request body. Each resulting object contains the average skill rating for the team for that course, as well as the constituent ratings that factored into the average.
GET /skills/courses/:wikiid/teams
Returns a list of all teams containing at least 1 team member partially skilled in a course, along with the average skill rating for all team members on that course.
POST /skills/courses/:wikiid/teams/details
Returns a list of objects for each team id sent in the request body. Each resulting object contains the average skill rating of the course for that team, as well as the constituent ratings that factored into the average.
GET /skills/guides/:guideid/teams
Returns a list of all teams containing at least 1 team member with a skill rating for the specified guide, along with the average skill rating for all team members on that guide.
POST skills/guides/$guideid/teams/details
Returns a list of objects for each team id sent in the request body. Each resulting object contains the average skill rating of the guide for that team, as well as the constituent ratings that factored into the average.
GET /skills/weights
Get all skill rating weight types and values. Authenticated user must be an admin or team lead.
PUT /skills/weights
Update skill rating values. All values within a group must add to 1. If a group is omitted from the request body then it will not be changed. Currently limited to admin users.
POST /skills/matrix
Retrieve skills matrix data for a list of users and docs. Only guides are supported at this time, and wiki support will be added in the future. Authenticated user must be an admin or team lead.
GET /skills/ratings/{doctype}/{docid}/{userid}
Get a detailed breakdown of the training and skill rating for a user and corresponding doc. The data includes the current weighting, value assigned to the user, and calculated total. Authenticated user must be an admin or team lead.
POST /skills/ratings/supervisor
Sets the supervisor rating for multiple users and documents. Rating is on a scale from 0 to 1. If a rating already exists for the user and document, it will be updated. Authenticated user must be an admin or team lead.
POST /skills/ratings/supervisor/:doctype/:docid/:userid
Sets supervisor rating for a user on a document. Rating is on a scale from 0 to 1. If a rating already exists it will be updated. Authenticated user must be an admin or team lead.