The essential first step of any flow with the Skill Engine API is creating the Entities within the system. This is done by sending over the entity information to the respective endpoint (
/employees to create an Employee, to
/vacancies to create a Vacancy). The sequence diagram below shows the flow for a single Employee. Its structure would be identical for other Entity types, and adding multiple Employees is just a matter of repeating the flow.
After the initial creation, the Entity can be updated through its Entity-specific endpoint, e.g.
/employees/101 for an Employee with ID 101.
After the creation of a skill profile for an Employee or Vacancy, you or your user might still have something to add (or remove). Taking this feedback into account makes for a win-win situation; improving the user experience, the quality of your data and the accuracy of any matches generated.
This can be done by sending a
PUT request to respectively the