---
title: "Upsert managed skill"
method: POST
path: "/hris/skills"
tags: ["Unified HRIS API"]
---

# Upsert managed skill

`POST /hris/skills`

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

```json
{
  "origin_id": "skill-1",
  "name": "TypeScript Programming",
  "status": "ACTIVE"
}
```

## Headers

- `X-Integration-Id` string, required

## Request body

- PostHrisSkillsRequestBody
  - `origin_id` string, required — A stable identifier for this skill in your system. Re-sending the same `origin_id` updates the skill.
  - `name` string, 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 `200`

POST /hris/skills Positive response

- PostHrisSkillsPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `origin_id` string, required — A stable identifier for this skill in your system. Re-sending the same `origin_id` updates the skill.
    - `name` string, required — The name of the skill.
    - `deactivated_at` string, date-time, nullable, required — When the skill was deactivated, or `null` if it is active.
  - `warnings` object[], required — These are the interaction warnings that are shown in the dashboard. They are meant to provide debug information to you. We recommend logging them to the console.
    - `message` string, required

## Other responses

- `default` — The standard error response with the error codes for the HRIS use case.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/versions/1e45035b96d3/schema)