Versions Compared

Old Version 2

changes.mady.by.user Rezgar Cadro

Saved on

compared with

New Version Current

changes.mady.by.user Rezgar Cadro

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

  • Request:

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

  • Response (200):

    Code Block
    {
  "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

Note

Skill requirements in existing issues will not be affected.

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

  • Request:

    • Skill tree object

  • Response [JSON]:

    • Updated skill tree

Example:

  • Request:

    Code Block
    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):

    Code Block
    {"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"}]}