Sign in

v3

OpenAPI 3.1.02026-07-311255771.3 MB
Unified HRIS API

Upsert employee skill proficiency rating

Assign a skill to an employee with an optional proficiency rating, attributed to the provider configured in the settings. Re-sending the same skill and source overwrites the existing rating.

<Note> This endpoint requires the permission **Manage employee skill proficiency ratings** to be enabled in [your scope config](/scopes). </Note>

Example Request Body

{
  "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
  "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
  "rating": {
    "rating_source": "EXTERNAL",
    "proficiency": 4
  }
}
post/hris/skill-proficiency-ratings

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

employee_idstring required

The Kombo ID of the employee.

skill_idstring required

The Kombo ID of the skill.

Response

POST /hris/skill-proficiency-ratings Positive response

status'success' required

Example response

{
  "data": {
    "id": "8AvRLpxwY5J6pGxfY6fUD81Z",
    "remote_id": "238476582-99123",
    "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
    "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
    "proficiency": {
      "selected_option_id": "3aKMdr68N8kG9EzLwjsN4",
      "type": "SINGLE_SELECT"
    },
    "rating_source": "EXTERNAL",
    "rating_provider_id": "7xPdr68N8kG9EzLwjsN9xyz",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": null,
    "custom_fields": null,
    "integration_fields": []
  }
}