Skip to main content
PATCH
/
hris
/
skills
/
{skill_id}
Update skill
curl --request PATCH \
  --url https://api.kombo.dev/v1/hris/skills/{skill_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Integration-Id: <x-integration-id>' \
  --data '{
  "name": "<string>",
  "levels": [
    "<string>"
  ]
}'
{
  "status": "success",
  "data": {
    "id": "28KMdr68N8kG9EzLwjsN9aoz",
    "remote_id": "238476582",
    "name": "TypeScript Programming",
    "description": "The ability understand and write TypeScript code.",
    "orderedLevels": [
      "Proficiency Level 1",
      "Proficiency Level 2",
      "Proficiency Level 3",
      "Proficiency Level 4",
      "Proficiency Level 5"
    ],
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": 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.
Update an existing skill in the HRIS system.

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.

Path Parameters

​
skill_id
string
required

The ID of the skill

Body

application/json

PATCH /hris/skills/:skill_id Request body

​
name
string

The name of the skill

​
levels
string[]

List of available skill levels (e.g., ["Beginner", "Intermediate", "Advanced"])

Response

PATCH /hris/skills/:skill_id Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Examples:
{
  "id": "28KMdr68N8kG9EzLwjsN9aoz",
  "remote_id": "238476582",
  "name": "TypeScript Programming",
  "description": "The ability understand and write TypeScript code.",
  "orderedLevels": [
    "Proficiency Level 1",
    "Proficiency Level 2",
    "Proficiency Level 3",
    "Proficiency Level 4",
    "Proficiency Level 5"
  ],
  "changed_at": "2022-08-07T14:01:29.196Z",
  "remote_deleted_at": null,
  "remote_data": null
}