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):

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:

• Response (200):

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:

• Response (200):

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:

• Response (200):

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:

   

• Response (200):