Claim skills

Some skills do not require completing a training to be considered acquired. A skill assigned with the ACCESSORY criticality can be self-declared as claimed by the learner directly, or approved from a submitted CV.

Claim a skill directly

To claim a skill, claimSkill mutation should be executed.

Argument	Type	Description
`skillId`	`ID`	Required. ID of the skill term that should be claimed.

A skill can only be claimed if all the following conditions are met:

The skill is assigned to the current API user context as a target skill (individually, or as a part of a skills profile), with its criticality set to ACCESSORY.
All of its sub-skills, if any, are already acquired or claimed.
All of its prerequisites, if any, are already acquired or claimed.

Here is an example of the mutation execution:

mutation claimSkill {
  claimSkill(skillId: 7) {
    errors
    response {
      skill {
        name
      }
      acquisitionStatus
      acquisitionSource
      acquiredOn
    }
  }
}

{
  "data": {
    "claimSkill": {
      "errors": [],
      "response": {
        "skill": {
          "name": "Promoting"
        },
        "acquisitionStatus": "CLAIMED",
        "acquisitionSource": "CLAIMED",
        "acquiredOn": 1782918513
      }
    }
  }
}

If the skill cannot be claimed (wrong criticality, unmet sub-skills or prerequisites), errors will contain the corresponding violation.

`UserSkillResponse` API object

Parameter	Type	Description
`errors`	`[Violation]`	Validation errors or violations encountered during the process.
`response`	`UserSkill`	The related `UserSkill` object, if the request was executed without any errors.

Request a CV skills review

A learner can also submit a CV together with a list of skills they believe it demonstrates. A manager then reviews the CV and confirms which of the suggested skills are approved. Once confirmed, an approved skill appears as claimed for the related user context, with the acquisition source CV_APPROVAL. To submit a CV for review, requestCvSkillsReview mutation should be executed.

Argument	Type	Description
`cvBase64`	`UploadedFileInput`	Required. The CV file. Max file size — 20 Mb. Allowed extensions — pdf.
`skillIds`	`[ID!]`	Required. IDs of the skill terms that should be confirmed during the review.

Here is an example of the mutation execution:

mutation requestCvSkillsReview {
  requestCvSkillsReview(
    cvBase64: {
      filename: "cv.pdf"
      contentBase64: "JVBERi0xLjQKJcOkw7zDtsO...="
    }
    skillIds: [4, 7]
  ) {
    errors
    response {
      id
      skills {
        name
      }
    }
  }
}

{
  "data": {
    "requestCvSkillsReview": {
      "errors": [],
      "response": {
        "id": "20",
        "skills": [
          {
            "name": "Communication"
          },
          {
            "name": "Promoting"
          }
        ]
      }
    }
  }
}

`CvSkillsReview` API object

Parameter	Type	Description
`cv`	`MediaFile`	Required. The submitted CV file.
`id`	`ID`	Required. ID of the CV skills review entity.
`skills`	`TaxonomyTerm`	Optional. The list of skills that correspond to the CV and should be reviewed.

`CvSkillsReviewResponse` API object

Parameter	Type	Description
`errors`	`[Violation]`	Optional. Validation errors or violations encountered during the process.
`response`	`CvSkillsReview`	Optional. The created `CvSkillsReview` object, described above, if the request was executed without any errors.

Getting started

Integration & Concepts

Use cases

Hierarchy Management

Zapier Integration

Mobile application

Claim a skill directly

`UserSkillResponse` API object

Request a CV skills review

`CvSkillsReview` API object

`CvSkillsReviewResponse` API object

​Claim a skill directly

​UserSkillResponse API object

​Request a CV skills review

​CvSkillsReview API object

​CvSkillsReviewResponse API object

Claim a skill directly

`UserSkillResponse` API object

Request a CV skills review

`CvSkillsReview` API object

`CvSkillsReviewResponse` API object