Page Comparison

About

The API enables you to interact with Skills for Jira programmatically. Use this API to migrate data to/from external systems, implement automation around skills (e.g. add a skill to Assignee upon task completion) or develop any other type of integration.

...

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

...

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://atlassian-dev.net/x1/add-user-skills{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"] }

...

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://atlassian-dev.net/x1/remove-user-skills{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"] }

...

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://atlassian-dev.net/x1/get-all-user-skills{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" ]
  }
}

...

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://atlassian-dev.net/x1/bulk-update-user-skills{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" ]
    }
  }
}

...

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

...

Request:

Code Block
HTTP GET: https://atlassian-dev.net/x1/get-skill-tree-with-experts{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" ]
                  }
              ]
          }
        ]
    }
  ]
}

Versions Compared

Old Version 5

New Version 6

Key

About