Skip to main content
POST
/
hris
/
employee-skill-assignments
Upsert employee skill assignment
curl --request POST \
  --url https://api.kombo.dev/v1/hris/employee-skill-assignments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '
{
  "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
  "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
  "proficiency": {
    "type": "NUMERIC",
    "value": 4
  }
}
'
{
  "status": "success",
  "data": {
    "id": "8AvRLpxwY5J6pGxfY6fUD81Z",
    "remote_id": "238476582-99123",
    "employee_id": "26vafvWSRmbhNcxJYqjCzuJg",
    "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
    "proficiency": {
      "type": "SINGLE_SELECT",
      "ordered_options": [
        "Proficiency Level 1",
        "Proficiency Level 2",
        "Proficiency Level 3",
        "Proficiency Level 4",
        "Proficiency Level 5"
      ],
      "value": "Proficiency Level 4"
    },
    "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.
Assign a skill to an employee, optionally with a proficiency rating. Include a proficiency to record a rated result (e.g. an assessment), attributed to the provider configured on the connection where the system supports it; omit it to record the skill without a rating. Re-sending the same (employee, skill, rating_source) replaces the existing rating in place; ratings from a different source (e.g. a SELF / MANAGER rating read from the system) remain separate rows.

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/employee-skill-assignments Request body

​
employee_id
string
required

The Kombo ID of the employee.

​
skill_id
string
required

The Kombo ID of the skill.

​
proficiency
object

The proficiency to record. Omit to assign the skill without a rating (a bare tag).

Response

POST /hris/employee-skill-assignments 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",
    "ordered_options": [
      "Proficiency Level 1",
      "Proficiency Level 2",
      "Proficiency Level 3",
      "Proficiency Level 4",
      "Proficiency Level 5"
    ],
    "value": "Proficiency Level 4"
  },
  "rating_source": "EXTERNAL",
  "changed_at": "2022-08-07T14:01:29.196Z",
  "remote_deleted_at": null
}