API Versioning
Deprecations
This section lists all currently deprecated features in the SkillEngine API. Deprecated features will be supported for a certain period of time before being removed. We recommend updating your integration to use the newer alternatives as soon as possible.
December 2023
-
Introduced a
skill_id
field alongside Skill names in our API endpoints to avoid ambiguities and conflicts. Using Skill names in a request body to denote or update a Skill is deprecated, please useskill_id
instead. Existing functionality is backward-compatible.The following endpoints are affected:
PATCH /employees/{external_id}/skill_profile
PATCH /job_architecture/job_families/{job_family_external_id}/skill_profile
PATCH /job_architecture/jobs/{job_external_id}/skill_profile
PATCH /vacancies/{external_id}/skill_profile
PATCH /courses/{external_id}/skill_profile
PATCH /occupations/{external_id}/skill_profile