View Source

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

Skill requirements in existing issues will not be affected.

POST /rest/skillsforjira/1/skilltree
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"}]}