Page Comparison

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Get user skills

...

Get all users' skills

Returns a skill map for all users.

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

• Request:

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

• Response [JSON]:

  • skills: An array of all skill names that the user has expertise inskllsByUserKey: Skill map for all users

Example:

• Request:

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

• Response (200):

  Code Block
  language js
  {"skillsByUserKey":{"JIRAUSER10100":[{"key":"UseEngineering Case- WritingBeginner","addedAt":16847518990661684751913939,"addedBy":"admin"},{"key":"TestEngineering - PlanningProficient","addedAt":16847518990661684751913939,"addedBy":"admin"},{"key":"TestEngineering - AutomationExpert","addedAt":16847533427241684751913939,"addedBy":"admin"}]

Add user skills

Adds one or more of skills to the specified user.

• HTTP Method: PUT

• Request:

  • accountId (query) The account ID of the user. Required

  • skills (body): An array of skills to add. Required

• Response [JSON]:

  • added: An array of skills that were successfully added

  • existing: An array of skills that the user already had

Example:

• Request:

  Code Block
  HTTP PUT: https://{your-generated-endpoint-url}?accountId=3e63957f-c263-41cd-acda-748560232d49 { "skills":["Engineering - Beginner","JavaScript", "HTML/CSS"] }

• Response (200):

  Code Block
  { "added":["HTML/CSS"], "existing":["Engineering - Beginner","JavaScript"] }

Remove user skills

Removes one or more skills from the specified user.

• HTTP Method: DELETE

• Request:

  • accountId (query) The account ID of the user. Required

  • skills (body): An array of skills to remove. Required

• Response [JSON]:

  • removed: An array of user’s skills that were successfully deleted

  • missing: An array of skills that the user did not possess

Example:

• Request:

  Code Block
  HTTP DELETE: https://{your-generated-endpoint-url}?accountId=3e63957f-c263-41cd-acda-748560232d49 { "skills":["HTML/CSS", "Product Discovery"] }

• Response (200):

  Code Block
  { "removed":["HTML/CSS"], "missing":["Product Discovery"] }

Get all users' skills

Returns the mapping of all experts and their skills in your Jira instance

• HTTP Method: GET

• Request: None

• Response [JSON]:

  skillsByAccountId: users / skills mapping

  ,"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:

  Code Block
  HTTP GET: httpshttp://{your-generated-endpoint-url}your-instance.com/rest/skillsforjira/1/expertise/JIRAUSER10001

• Response (200):

  Code Block
  language js
  [{ "skillsByAccountIdkey":"Use { "3e63957f-c263-41cd-acda-748560232d49": [ "Engineering - Beginner", "JavaScript", "HTML/CSS" ], "63314adf8b75455be455c8a0": [ "Marketing - Competent", "Marketing - Expert", "English - Expert", "Social Media Marketing"], "61a4ad9cf241500072f37d74": [ "QA - Competent", "Test Automation", "Selenium", "Python" ] } }Case Writing","addedAt":1684751899066,"addedBy":"admin"},{"key":"Test Planning","addedAt":1684751899066,"addedBy":"admin"},{"key":"Test Automation","addedAt":1684753342724,"addedBy":"admin"}]

Bulk update users skills

Updates skill sets of multiple users at once

• HTTP Method: POST

• Request:

  • skillsByAccountIdskillsByUserKey: users / skills mapping

• Response [JSON]:\

  • changes: all user All users' skill changes after the import is processed

...

• Request:

  Code Block
  HTTP POST: https://{your-generated-endpoint-url} { "skillsByAccountIdskillsByUserKey": { "3e63957f-c263-41cd-acda-748560232d49admin": [ "Engineering - Beginner" ], "63314adf8b75455be455c8a0": [ "Marketing - Expert", "Marketing - Master", "English - Expert", "Social Media Marketing"], } }

• Response (200):

  Code Block
  { "changesadmin": { "3e63957f-c263-41cd-acda-748560232d49": { "added": [], "removed": [ "JavaScript", "HTML/CSS" ] }, "63314adf8b75455be455c8a0": { "added": [ "Marketing - Master" ], "removed": [ "Marketing - Competent" ] } } }

Get skill tree with experts

Returns the complete skill tree with a list of experts specified for each skill

• HTTP Method: GET

• Request: None

• Response [JSON]:

  • experts: skill tree with a list of experts specified for each skill

Example:

• Request:

  Code Block
  HTTP GET: https://{your-generated-endpoint-url}

  Response (200):

  Code Block

  { "experts": [ { "key": "f2c4cba9-6082-48c8-b23e-852e101bedbd", "type": "category", "displayName": "Design", "children": [ { "key": "9935f79d-02d1-4415-a81b-04f9e9dcd7ce", "type": "category", "displayName": "UX" "children": [ { "key": "User Flows", "experts": [ "3e63957f-c263-41cd-acda-748560232d49" ] }, { "key": "Wireframes", "experts": [] }, { "key": "Usability Testing", "experts": [ "3e63957f-c263-41cd-acda-748560232d49", "63314adf8b75455be455c8a0" ] } ] } ] } ] "addedSkillKeys":["Engineering - Expert"],"removedSkillKeys":["Engineering - Master"]}}