v3

OpenAPI 3.1.02026-07-311255771.3 MB

Unified HRIS API

Upsert staffing entity skill expectation

Add a skill expectation on a staffing entity, with an optional expected proficiency level. Re-sending the same skill updates the expectation in place.

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

Example Request Body

{
  "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
  "expected_proficiency": 4
}

post/hris/staffing-entities/{staffing_entity_id}/skills

Path parameters

staffing_entity_idstring required

The Kombo ID of the staffing entity to attach the skill to.

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

skill_idstring required

The Kombo ID of the skill.

Response

POST /hris/staffing-entities/:staffing_entity_id/skills Positive response

status'success' required

Example response

{
  "data": {
    "id": "C8gqYqWk6N3qjvJ8vh5o3VtH",
    "staffing_entity_id": "26vafvWSRmbhNcxJYqjCzuJg",
    "skill_id": "28KMdr68N8kG9EzLwjsN9aoz",
    "expected_proficiency": {
      "type": "NUMERIC",
      "value": 4
    },
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null
  }
}