User Skill management API

Get all users' skills

Returns a skill map for all users.

• GET /rest/skillsforjira/1/expertise

• Request:

  • None

• Response [JSON]:

  • skllsByUserKey: Skill map for all users

Example:

• Request:

  HTTP GET: http://your-instance.com/rest/skillsforjira/1/expertise

• Response (200):

  {"skillsByUserKey":{"JIRAUSER10100":[{"key":"Engineering - Beginner","addedAt":1684751913939,"addedBy":"admin"},{"key":"Engineering - Proficient","addedAt":1684751913939,"addedBy":"admin"},{"key":"Engineering - Expert","addedAt":1684751913939,"addedBy":"admin"}],"admin":[{"key":"Use Case Writing","addedAt":1684751899066,"addedBy":"admin"},{"key":"Test Planning","addedAt":1684751899066,"addedBy":"admin"},{"key":"Test Automation","addedAt":1684753342724,"addedBy":"admin"}]},"userKeysBySkillKey":{"Test Automation":["admin"],"Engineering - Beginner":["JIRAUSER10100"],"Engineering - Proficient":["JIRAUSER10100"],"Test Planning":["admin"],"Engineering - Expert":["JIRAUSER10100"],"Use Case Writing":["admin"]}}

Get user skills

Returns all skills of the specified user.

• GET /rest/skillsforjira/1/expertise/{userKey}

• Request:

  • userKey (path): Key of the target user. Required

• Response [JSON]:

  • An array of all skills that the user has expertise in

Example:

• Request:

  HTTP GET: http://your-instance.com/rest/skillsforjira/1/expertise/JIRAUSER10001

• Response (200):

Add user skills

Adds new skills to the specified user

• PUT /rest/skillsforjira/1/expertise/{userKey}/add

• Request:

  • Array of skill keys to add

• Response [JSON]:

  • All users' skill changes after the import is processed

Example:

• Request:

• Response (200):

Remove user skills

Removes skills from the specified user

• PUT /rest/skillsforjira/1/expertise/{userKey}/remove

• Request:

  • Array of skill keys to remove

• Response [JSON]:

  • All users' skill changes after the import is processed

Example:

• Request:

• Response (200):