March 2023

• Add Update /employees/{employee_external_id}/skill_events/{skill_event_external_id} endpoint to support updating an Employee's Skill Event.
• Add Job and Job Family entities to job_architecture/jobs and job_architecture/job_families endpoints respectively.
• Add Job Profile Data and Job Family Profile Data to the job_architecture/job_families/{job_family_external_id}/profile_data and job_architecture/jobs/{job_external_id}/profile_data endpoints respectively.
• Add custom_property_is_in_list filter to POST employees/{employee_external_id}/recommended_courses.
• Add the property_value and assigned_position fields of an employee to the Skill Cluster Adoption report (reports/employees/skill_cluster_adoption).
• Add GET job_architecture/jobs/{job_external_id}/skill_profile and GET job_architecture/job_families/{job_family_external_id}/skill_profile endpoints
• Add match_feedback option for the include parameter of the /employees/{employee_external_id}/matching_vacancies and /vacancies/{vacancy_external_id}/matching_employees endpoints, which includes feedback given to a match in the result if applicable.
• Custom Properties have been added to the Job and Job Family entities. They can be requested by using the custom_properties include option when sending to the GET job_architecture/jobs/{job_external_id} and GET job_architecture/job_families/{job_family_external_id} endpoints.
• Add Update /job_architecture/jobs/{job_external_id}/profile_data/{profile_data_external_id} and Update /job_architecture/job_families/{job_family_external_id}/profile_data/{profile_data_external_id} endpoints to support updating Job Profile Data and Job Family Profile Data.
• Create or update working history skill events using a job_id at POST /employees/{employee_external_id}/skill_events and PATCH /employees/{employee_external_id}/skill_events/{skill_event_external_id} respectively

February 2023

• Add the multi_max_geo_distances filter in matching for endpoints /employees/{external_id}/matching_vacancies and /vacancies/{external_id}/matching_employees.
• Add the Succession Risk Report available under the /reports/succession_risk endpoint.
• Add the rejected_skills include option to the POST /export/employees/skill_clusters endpoint.
• Add the option to create learning skill events from a course_id

January 2023

• Add competency_type in GET /competencies and GET /competencies/{external_id}.
• Add support for specifying the location in LocationAddress format in the MaxGeoDistanceFilter.
• Add the Replacement Risk Report available under the /reports/replacement_risk endpoint.

December 2022

• The Get Skill Profile endpoints /entity_type/{external_id}/skill_profile with response_format=competencies now return skill information.
• Add custom_property_list_overlap filter for Employee and Vacancy matching.
• Add GET vacancies/{vacancy_external_id}/metrics/fillability endpoint, which calculates the fillability metric of a Vacancy. The fillability is influenced by the number of matching Employees and the number of Vacancies that can be filled by those Vacancies. More matching Employees will result in a higher fillability, and more matching Vacancies will result in a lower fillability.
• Add POST vacancies/{vacancy_external_id}/metrics/fillability endpoint which allows for filtering the used entities on maximal allowed distance and custom properties, and assigning weights to the different factors used in the fillability calculation.
• Add exclude_match_feedback filter to POST employees/{employee_external_id}/recommended_courses and POST employees/{employee_external_id}/matching_vacancies
• Add DELETE endpoints to employees/{employee_external_id}/vacancies/{vacancy_external_id}/match_feedback and employees/{employee_external_id}/courses/{course_external_id}/match_feedback
• Add include=competencies query parameter to vacancies/{vacancy_external_id}/matching_employees.
• Add include query parameter for the employees/{employee_external_id}/similar endpoint. Possible values are: entity, competencies and custom_properties.
• Add validation_state to skills returned from GET employees/{employee_external_id}/skill_profile endpoint in list and competency format.
• Add validation_state to skills returned from POST export/employees/competencies endpoint.
• Add exclude_match_feedback filter to the employees/search and vacancies/search endpoints.
• Add related_skills to include in POST export/employees/competencies endpoint.
• Adding a proficiency_level to a competency in the body is no longer required when sending feedback via PUT or PATCH to /employees/{employee_external_id}/skill_profile?feedback_format=competencies
• Add score_breakdown option for the include parameter of the /employees/{employee_external_id}/matching_vacancies and /vacancies/{vacancy_external_id}/matching_employees endpoints, which includes a breakdown of the contribution of all input weights to the total match score in the response body.

November 2022

• Add the skill_notes event type.
• Add the Competency Adoption Report available under the /reports/employees/competency_adoption endpoint.
• Add POST employees/{employee_external_id}/metrics/employability endpoint which allows for filtering the used entities on maximal allowed distance and custom properties, and assigning weights to the different factors used in the calculation.
• Add PATCH endpoint to vacancies/{external_id}/skill_profile, occupations/{external_id}/skill_profile and courses/{external_id}/skill_profile.
• Add include=relevant_experience query parameter to employees/{employee_external_id}/matching_vacancies and vacancies/{vacancy_external_id}/matching_employees.
• For LocationAddress inputs, city can be used instead of postal_code now, making one of them required instead of having postal_code required.
• The Get Skill Profile endpoints /entity_type/{ID}/skill_profile with response_format=competencies now return skill category information.

October 2022

• Add a not equals option (neq) to the custom_property filter.
• Add sources in the /export/employees/competencies endpoint, to be able to track from which skill events the given competencies originate from.
• Add support for addresses as an alternative for location coordinates.

August 2022

• Add include query parameter to vacancies/{vacancy_external_id}/matching_employees to allow retrieving employee information without extra calls.
• Add include=location query parameter option to employees/{employee_external_id}/matching_vacancies
• Add a validation_state field to the /export/employees/competencies response. Indicating whether the competencies linked to employees are already validated by a manager or employee or still suggested.

July 2022

• Add a category field to the POST /competencies and PATCH /competencies/{external_id} endpoints to change the category of a competency.

June 2022

• Add a PATCH endpoint for skill profile feedback on Employees such that skill profiles can be partially updated.
• Add last_updated filter for Employee and Vacancy matching.
• Add an experimental POST /export/employees/competencies endpoint for extracting employee competencies and skills from the API.

May 2022

• Change how the GET /competencies/{external_id}/skill_profile endpoint returns skill profiles for clients who use a Taxonomy managed by TechWolf.

April 2022

• Add support for project and certificate Skill Events.
• Add support for explicit working_history, education_history, and resume_document Skill Events.

March 2022

• Add support for feedback and goal Skill Events.

February 2022

• Add include query parameter to employees/{employee_external_id}/recommended_courses to allow retrieving course information without extra calls.

January 2022

• Add Delete /employees/{employee_external_id}/skill_events/{skill_event_external_id} endpoint to support removing an Employee's Skill Event from the API.
• Add GET /employees/{employee_external_id}/skill_events endpoint to support fetching an Employee's Skill Events of a specified type in the API. The only allowed event type is a learning_event.
• Add POST /employees/{employee_external_id}/skill_events endpoint to support the creation of Skill Events in the API. The only allowed event type is a learning_event.

December 2021

• Add /employees/{employee_external_id}/recommended_courses endpoint, returning the recommended Courses to improve an Employee's skill profile.
• Removed Certificates from Employees and all its functionalities.
• The custom property weights for the matching endpoints now support the custom_property_contains, custom_property_contains_element , custom_property_is_in and custom_property_is_in_list configurations. Match scores are increased when the applied condition on the matching entities' specified custom property checks out.
• The matching endpoints now support the language weight configurations. Match scores are increased when the matching entities' language levels fall between a range of the source entity language levels.

October 2021

• All endpoints supporting the explained response format now return additional category information when the explained response format is requested.
• The Get Skill Profile endpoints /entity_type/{ID}/skill_profile now support response_format=categories and thereby return skill category information.
• The Skill Search endpoint /skills/search now returns skill category information.
• The Search endpoints now support German (de) language.
• You can now create and update entities in German with the language=de query parameter.
• The Reskilling & Deployment report now provides information for key missing skills on an Employee-level.

September 2021

• The /employees/{employee_external_id}/vacancies/{vacancy_external_id}/match endpoint with response_format=explained query parameter now returns the body with missing skills included under the missing_skills key.
• Add external Company hiring activity profiling with NACE-codes under the /companies/{external_id}/nace endpoint.
• Add the Reskilling & Deployment Report available under the /reports/reskilling_and_deployment endpoint.
• Reskilling & Deployment report now supports a Qlik-friendly CSV output format.
• Reskilling & Deployment report now supports score_min_threshold.
• The external_id_is_in_list filter is now supported for the Job Matching and external Company Matching endpoints. Additionally, this filter is also supported for the Search and Similar endpoints of Employee, Vacancy, and external Company.

August 2021

• The Employability metric now takes into account the supply of Employees that could fill in the demand as well.
• The Search endpoints now support an optional language query parameter, to indicate the language of the input text.

July 2021

• companies/:external_id/desired_functions now supports the PUT method. Calling this method replaces all existing desired function vacancies with the new set.
• Similar Entity endpoints now support score_min_threshold.
• Similar Entity endpoints now support custom property filters.
• Similar Entity endpoints for Employees and Vacancies now support location and language based filters.
• Similar Entity endpoints now support custom property weights.
• Similar Entity endpoints for Employees and Vacancies now support location weight.

June 2021

• Add the option to override the location used for geo-distance calculation in matching request filters.
• max_geo_distance field on Employee entities was deprecated.
• remove max_geo_distance field on Employee entities.

May 2021

• You can now use a vacancy-prefix when looking for matching external companies such that filtering and weighting is based on the custom properties of the vacancies associated with the external company, rather than the external company itself.

April 2021

• Add strict parameter to entity creation and update operations (Employees, Competencies, Courses, Documents, Occupations, Vacancies).
• Change the outward facing side of (non-)desired functions during Employee creation. Output and input now better reflect internal results.
• Add languages field to external Companies.
• You can now add a geo distance weight to the matching endpoints. Match scores are increased when two entities are in proximity to each other.
• You can now add custom property weights to the matching endpoints. Match scores are increased when the applied condition on the matching entities' specified custom property checks out.
• Extraction language can now be specified for the POST companies/{external_id}/desired_functions endpoint.

March 2021

• You can now specify the non-desired functions when creating or updating an Employee to take their negative preference into account when matching to new positions.
• You can now modify the non-desired functions boost used during matching by setting the appropriate weight on the match endpoints employees/{external_id}/matching_vacancies and vacancies/{external_id}/matching_employees.
• You can now submit multiple desired functions linked to a given External Company through a single multiline string using the new request_format=free_text query parameter on the /companies/{external_id}/desired_functions endpoint.
• You can now submit free text, multiline strings desired functions & non-desired functions for an Employee through the desired_functions & non_desired_functions attributes.
• You can now search for Vacancies and external Companies based on free text, through the endpoints /vacancies/search and /companies/search.
• You can now add datetime-typed custom properties.
• You can now provide a list of filters when searching for entities using free text through the endpoints /employees/search, /vacancies/search and /companies/search.
• You can now provide multiple values (as a list) when using the custom_property_contains_element filter. Entities will not be filtered out if they contain at least one of the provided values in the list custom property.
• You can now specify the comparison operator when using the custom_property filter. If no operator is specified, the filter defaults to the equals operator.
• You can now specify an offset on matching endpoints for employees ,vacancies and companies.
• You can now specify an offset on search endpoints for employees,vacancies and companies.
• You can now pass the null value for optional fields during creation and updating of all entities. Passing the null value during an update will unset the entity's attribute. Objects will be unset as null, arrays as the empty array [] and strings as the empty string ''.
• External Companies now support custom properties.
• (Non-)desired function score boosting is now calculated relative to the relevancy of the function title, instead of a binary boost on occurrence of a title.
• You can now provide a list of filters at the match endpoints employees/{external_id}/matching_companies and companies/{external_id}/matching_employees. This will be used to filter out entities that do not need to be considered during matching.
• You can now provide a list of weights at the match endpoints employees/{external_id}/matching_companies and companies/{external_id}/matching_employees. The weights can override some default weights during matching (e.g. desired functions boost).
• Custom property definitions are no longer allowed to contain double underscores in their name.
• You can now set the weight of the skills-related match component contributing to the final match score (this was previously hard-coded to 1.0).
• You can now filter on the custom properties of External Companies linked to a Vacancy, when matching Employees to Vacancies and vice versa.

February 2021

• You can now search for Employees based on free text, through the endpoint /employees/search.
• You can add an (optional) External Company link to a Vacancy, through the endpoint /vacancies and attribute company.
• You can now list, create, retrieve, update and delete External Companies through the endpoints /companies/*.
• You can now optionally mark Vacancies as inactive using the field active. When this is field has the value False, the Vacancy will not be used for matching.
• Deleting External Companies now deletes all linked inactive Vacancies in cascade.
• You can now find the best Employees for a given External Company with an overview of its matching Vacancies, through the endpoint /companies/{external_id}/matching_employees.
• You can now find the best External Companies for a given Employee with an overview of the matching Vacancies per External Company, through the endpoint /employees/{external_id}/matching_companies.
• You can now upload desired functions as inactive Vacancies linked to a given External Company, through the endpoint /companies/{external_id}/desired_functions.
• You can now see when an entity was last updated by checking the attribute last_updated upon entity retrieval.
• You can now provide a list of filters at the match endpoints employees/{external_id}/matching_vacancies and vacancies/{external_id}/matching_employees. This will be used to filter out entities that do not need to be considered during matching.
• You can now provide a list of languages with proficiency levels during Vacancy creation.
• You can now provide a list of weights at the match endpoints employees/{external_id}/matching_vacancies and vacancies/{external_id}/matching_employees. The weights can override some default weights during matching (e.g. desired functions boost).
• The POST-type methods on matching_vacancies and matching_employees are now the preferred way to request the matches.
• You can now add a list of strings as a Custom Property.
• You can now explicitly provide the language used in skill profile extraction during entity creation/update using the language query parameter. Supported languages are auto, nl, fr and en.
• You can now optionally add a job description to the entries in the working_history of an Employee. These descriptions will also be used for skill extraction.

January 2021

• You can add a (optional) max_geo_distance attribute when creating an Employee through the endpoint /employees. This is used for matching if there is no max_geo_distance. provided as query parameter. The default distance in our system when nothing is provided, is 50 km.

2023-02-21

• The desired_functions and non_desired_functions fields of the Employee have been changed from lists of titles to list of Function objects. A Function object consists of a Function title and a relative importance.

2023-01-27

• All instances of competency, competencies or capitalized alternatives have been renamed to skill_cluster and skill_clusters, and their capitalized versions.
• All instances of category, categories or capitalized alternatives have been renamed to domain and domains, and their capitalized versions.

2022-10-24

• The competency and score fields in PUT, PATCH /{entity}/{external_id}/skill_profile in competencies format are now renamed to competency_name and proficiency_level respectively.

• The score fields in PUT, PATCH /{entity}/{external_id}/skill_profile in skills format is replaced by has_skill which is a boolean instead of number.

2022-10-05

• The competency and score fields in GET /{entity}/{external_id}/skill_profile in competencies format are now renamed to competency_name and proficiency_level respectively.

2022-07-19

• The score field in GET /{entity}/{external_id}/skill_profile in list format is now optional.

2022-07-18

• Deprecated GET /employees/{external_id}/recommended_courses and added POST instead.

2022-06-03

• Removed POST /competencies/{external_id}/similar and POST /competencies/{external_id}/profile/related endpoints.

2022-05-23

• Removed PUT /competencies/{external_id}/skill_profile feedback endpoint.

2021-11-09

• Removed Document Entity and all its functionalities.

2021-07-28

• Similar Entity endpoints are now POST instead of GET.
• The response format of Similar Entity endpoints has changed from a list to an object containing two fields: the list of results and the total number of results available.

2021-06-04

• Search endpoints now require weights in the body, in the same manner as matching endpoints.
• Search endpoints now support a score_min_threshold query parameter, and defaults to 0.5 for this value instead of the previously internal 0.0.

2021-04-30

• The language query parameter has become required for the creation and update of an entity.

2021-03-19

• The response format of matching results (GET/POST /employees/{external_id}/matching_vacancies , GET/POST /vacancies/{external_id}/matching_employees , GET /employees/{external_id}/matching_companies and GET /companies/{external_id}/matching_employees) has changed from a list to an object containing two fields: the list of results and the total number of results available.
• The response format of search results (POST /employees/search , POST /vacancies/search and POST /companies/search) has changed from a list to an object containing two fields: the list of search results and the total number of results available from the free text search.
• The response format of list results (GET /employees/, GET /vacancies/ , GET /companies/, GET /courses/, GET /competencies/, GET /documents/ and GET /occupations/) has changed from a list to an object containing two fields: the list of results and the total number of results available.

2021-02-25

• Employee creation (POST /employees) and updates (PATCH /employees/{external_id}) no longer support uploading individual resumes (as employee_resume) in favour of accepting a list of multiple resumes (as employee_documents) with the same format.

2021-02-03

• The list entity endpoints (GET /employees, GET /vacancies, GET /courses , GET /occupations, GET /competencies and GET /documents) no longer support the response_format query parameter. The response now corresponds to the former objects response format for all endpoints.

2021-01-19

• The version endpoint now returns a body with a single field version, indicating the current version of your tenant. The version is returned as a date (ISO-8601, ex. 2021-01-19) and no longer as a number.