v6

latestOpenAPI 3.1.02026-08-071255851.3 MB
Unified HRIS API

Upsert managed skill

Create or update a skill in the catalog managed by your system.

Stores the skill in Kombo immediately and only sends it to the HRIS during subsequent syncs. This lets you submit thousands of skills without worrying about the rate limits of the remote system.

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

Example Request Body

{
  "origin_id": "skill-1",
  "name": "TypeScript Programming",
  "status": "ACTIVE"
}
post/hris/skills

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

origin_idstring required

A stable identifier for this skill in your system. Re-sending the same origin_id updates the skill.

namestring required

The name of the skill.

status'ACTIVE' | 'INACTIVE'

The desired status of the skill in the remote HRIS. INACTIVE requests deactivation or archival where supported.

Response

POST /hris/skills Positive response

status'success' required

Example response

{
  "data": {
    "origin_id": "skill-1",
    "name": "TypeScript Programming",
    "deactivated_at": null
  }
}