...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
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
...
Request:
Code Block HTTP GET: https://atlassian-dev.net/x1/get-user-skills?accountId=3e63957f-c263-41cd-acda-748560232d49
Response (200):
Code Block { "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
...
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
...
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
...
Request:
Code Block HTTP GET: https://{your-generated-endpoint-url}Response (200):
Code Block { "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
...
Request:
Code Block 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):
Code Block { "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
...