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/global

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