User Skill management API

Endpoints

Get user skills

Returns all skills of the specified user.

• HTTP Method: GET

• Request:

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

• Response [JSON]:

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

Example:

• Request:

  HTTP GET: https://atlassian-dev.net/x1/get-user-skills?accountId=3e63957f-c263-41cd-acda-748560232d49

• Response (200):

  { "skills":["Engineering - Beginner","JavaScript", "HTML/CSS"] }

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:

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

• Response (200):

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

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

• Response (200):

  { "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

Example:

• Request:

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

• Response (200):

  { "skillsByAccountId": { "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" ] } }

Bulk update users skills

Updates skill sets of multiple users at once

• HTTP Method: POST

• Request:

  • skillsByAccountId: users / skills mapping

• Response [JSON]:\

  • changes: all user skill changes after the import is processed

Example:

• Request:

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

• Response (200):

  { "changes": { "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:

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

   

• Response (200):

  { "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" ] } ] } ] } ] }