curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/{employee_external_id}/interactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "interaction_type": "vacancy_liked",
  "timestamp": "2023-06-08T14:42:31.130855",
  "vacancy_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7"
}'
This response has no body data.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

employee_external_id
string
required

Unique ID linked to an Employee, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100

Query Parameters

language
enum<string>
required

The language of the input data, which has an impact on the Skill extraction. auto will automatically detect the language used in the provided data.

Available options:
auto,
nl,
fr,
en,
de

Body

application/json

Default structure of an Employee Interaction.

external_id
string
required

The unique Employee Interaction ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Minimum length: 1
interaction_type
string
required

Type of the Employee Interaction.

timestamp

The completion date (in IS08601 format) of the Employee Interaction. This is the point in time at which the Employee interacted with a Vacancy or title. If not given, it will be automatically set to the creation time of the Employee Interaction.

vacancy_id
string

The ID of the Vacancy with which the Employee has interacted. Either a vacancy_id or a title should be provided, and not both.

title
string

The title with which the Employee has interacted. Either a vacancy_id or a title should be provided, but not both. A title can be any kind of free text, and does not need to be associated with an existing Vacancy.