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,
/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