Skip to main content
POST
/
hris
/
skill-proficiency-ratings
Upsert skill proficiency rating
curl --request POST \
  --url https://api.kombo.dev/v1/hris/skill-proficiency-ratings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '
{
  "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
  "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
  "proficiency": 4
}
'
{
  "status": "success",
  "data": {
    "id": "8AvRLpxwY5J6pGxfY6fUD81Z",
    "remote_id": "238476582-99123",
    "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
    "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
    "proficiency": {
      "type": "SINGLE_SELECT",
      "options": [
        {
          "id": "3aKMdr68N8kG9EzLwjsN1",
          "remote_id": "1",
          "name": "Proficiency Level 1"
        },
        {
          "id": "3aKMdr68N8kG9EzLwjsN2",
          "remote_id": "2",
          "name": "Proficiency Level 2"
        },
        {
          "id": "3aKMdr68N8kG9EzLwjsN3",
          "remote_id": "3",
          "name": "Proficiency Level 3"
        },
        {
          "id": "3aKMdr68N8kG9EzLwjsN4",
          "remote_id": "4",
          "name": "Proficiency Level 4"
        },
        {
          "id": "3aKMdr68N8kG9EzLwjsN5",
          "remote_id": "5",
          "name": "Proficiency Level 5"
        }
      ],
      "selected_option_id": "3aKMdr68N8kG9EzLwjsN4"
    },
    "rating_source": "EXTERNAL",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null
  }
}
Closed Beta Feature: This endpoint is currently in closed beta. We’re testing it with selected customers before its public release. If you’re interested in learning more or getting early access, please reach out.
Record a skill on an employee, with an optional proficiency rating, attributed to the provider configured on the connection. Re-sending the same skill from the same source replaces it in place.

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Body

application/json

POST /hris/skill-proficiency-ratings Request body

​
employee_id
string
required

The Kombo ID of the employee.

​
skill_id
string
required

The Kombo ID of the skill.

​
proficiency

The proficiency to record. For a NUMERIC skill, submit the numeric value (within the scale's min–max range). For a SINGLE_SELECT skill, submit the ID of the proficiency option. Omit to assign the skill without a rating.

Required range: x >= -1.7976931348623157e+308

Response

POST /hris/skill-proficiency-ratings Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Example:
{
  "id": "8AvRLpxwY5J6pGxfY6fUD81Z",
  "remote_id": "238476582-99123",
  "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
  "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
  "proficiency": {
    "type": "SINGLE_SELECT",
    "options": [
      {
        "id": "3aKMdr68N8kG9EzLwjsN1",
        "remote_id": "1",
        "name": "Proficiency Level 1"
      },
      {
        "id": "3aKMdr68N8kG9EzLwjsN2",
        "remote_id": "2",
        "name": "Proficiency Level 2"
      },
      {
        "id": "3aKMdr68N8kG9EzLwjsN3",
        "remote_id": "3",
        "name": "Proficiency Level 3"
      },
      {
        "id": "3aKMdr68N8kG9EzLwjsN4",
        "remote_id": "4",
        "name": "Proficiency Level 4"
      },
      {
        "id": "3aKMdr68N8kG9EzLwjsN5",
        "remote_id": "5",
        "name": "Proficiency Level 5"
      }
    ],
    "selected_option_id": "3aKMdr68N8kG9EzLwjsN4"
  },
  "rating_source": "EXTERNAL",
  "changed_at": "2022-08-07T14:01:29.196Z",
  "remote_deleted_at": null
}