Versions Compared

Key

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

Get all users' skills

Returns a skill map for all users.

  • GET /rest/skillsforjira/1/expertise

  • Request:

    • None

  • Response [JSON]:

    • skllsByUserKey: Skill map for all users

...

Returns all skills of the specified user.

  • GET /rest/skillsforjira/1/expertise/{userKey}

  • Request:

    • userKey (path): Key of the target user. Required

  • Response [JSON]:

    • An array of all skills that the user has expertise in

...

  • Request:

    Code Block
    HTTP GET: http://your-instance.com/rest/skillsforjira/1/expertise/JIRAUSER10001
  • Response (200):

    Code Block
    languagejs
    [{"key":"Use Case Writing","addedAt":1684751899066,"addedBy":"admin"},{"key":"Test Planning","addedAt":1684751899066,"addedBy":"admin"},{"key":"Test Automation","addedAt":1684753342724,"addedBy":"admin"}]

Bulk update users skills

Updates skill sets of multiple users at once

...

HTTP Method: POST

Request:

...

Add user skills

Adds new skills to the specified user

  • PUT /rest/skillsforjira/1/expertise/{userKey}/add

  • Request:

    • Array of skill keys to add

  • Response [JSON]:\

    • All users' skill changes after the import is processed

Example:

  • Request:

    Code Block
    HTTP POSTPUT: httpshttp://{your-generated-endpoint-url}
    {
      "skillsByUserKey": {
        "admin": [ your-instance.com/rest/skillsforjira/1/expertise/{userKey}/add
    [ "Engineering - Expert", "React" ]
  • Response (200):

    Code Block
    {"admin":{"addedSkillKeys":["Engineering - Expert", "React"],"removedSkillKeys":[]}}

Remove user skills

Removes skills from the specified user

  • PUT /rest/skillsforjira/1/expertise/{userKey}/remove

  • Request:

    • Array of skill keys to remove

  • Response [JSON]:

    • All users' skill changes after the import is processed

Example:

  • Request:

    Code Block
    HTTP PUT:  }
    }http://your-instance.com/rest/skillsforjira/1/expertise/{userKey}/remoev
    [ "React", "Java" ]
  • Response (200):

    Code Block
    {"admin":{"addedSkillKeys":["Engineering - Expert"],"removedSkillKeys":["Engineering - MasterReact"]}}