Skill Tree management API

Limits

• Max length of every string (e.g. keys, descriptions) is limited to 100 characters

• Strings starting or ending with white space are not allowed

Endpoints

Get skill tree

Returns the applicable skill tree

• GET /rest/skillsforjira/1/skilltree/global

• Request:

  • None

• Response [JSON]:

  • skillTree: Hierarchical skill tree including categories and skills

Example:

• Request:

  HTTP GET: https://{your-instance}/rest/skillsforjira/1/skilltree

• Response (200):

  {
    "skillTree": [
      {
          "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" },
                    { "key": "Wireframes" },
                    { "key": "Usability Testing" }
                ]
            }
          ]
      }
    ]
  }

Update skill tree

Updates the entire skill tree with a new version

• POST /rest/skillsforjira/1/skilltree/global

• Request:

  • Skill tree object

• Response [JSON]:

  • Updated skill tree

Example:

• Request:

  HTTP POST: https://{your-instance}/rest/skillsforjira/1/skilltree
  
  {"nodes":[{"key":"39cc406e-49c8-46c2-881e-2172c1252a7a","displayName":"Software Engineering","type":"category","description":"Software engineering skills","icon":"engineering","children":[{"key":"88167d41-c6af-49e2-9bcf-221b0ee4c655","displayName":"Levels","type":"category","children":[{"key":"Engineering - Beginner","type":"skill"},{"key":"Engineering - Competent","type":"skill"},{"key":"Engineering - Proficient","type":"skill"},{"key":"Engineering - Expert","type":"skill"},{"key":"Engineering - Master","type":"skill"}]}]}],"isPersisted":true}

• Response (200):

  {"nodes":[{"key":"39cc406e-49c8-46c2-881e-2172c1252a7a","description":"Software engineering skills","icon":"engineering","children":[{"key":"88167d41-c6af-49e2-9bcf-221b0ee4c655","children":[{"key":"Engineering - Beginner"},{"key":"Engineering - Competent"},{"key":"Engineering - Proficient"},{"key":"Engineering - Expert"},{"key":"Engineering - Master"}],"type":"category","displayName":"Levels"}],"type":"category","displayName":"Software Engineering"}]}