Skip to main content
POST
/
hris
/
skills
/
bulk
Upsert skills
curl --request POST \
  --url https://api.kombo.dev/v1/hris/skills/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '
{
  "items": [
    {
      "origin_id": "skill-1",
      "name": "TypeScript Programming"
    },
    {
      "origin_id": "skill-2",
      "name": "Kubernetes"
    }
  ]
}
'
{ "status": "success", "data": { "task_id": "task_28KMdr68N8kG9EzLwjsN9aoz" } }

Documentation Index

Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt

Use this file to discover all available pages before exploring further.

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.
Create or update multiple skills in the HRIS catalog. Each item is matched by its origin_id – re-sending the same origin_id updates that skill, a new one creates it.
Note: This endpoint is asynchronous – it returns a task_id immediately and processes the request in the background. Use the corresponding GET endpoint to poll for the task status until it reaches COMPLETED or FAILED. Learn more in our async endpoints guide.

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/skills/bulk Request body

​
items
object[]
required

The skills to create or update.

Response

POST /hris/skills/bulk Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Example:
{
  "task_id": "task_28KMdr68N8kG9EzLwjsN9aoz"
}