Skip to main content
Create a new Interaction for an Employee
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"
}
'
[
  {
    "title": "400 Bad Request",
    "description": "The request body was not structured correctly."
  }
]

Documentation Index

Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt

Use this file to discover all available pages before exploring further.

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<uuid>
required

Unique ID linked to an Employee, consisting of alphanumeric characters, hyphens and underscores. The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Pattern: [a-zA-Z0-9_-]+
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

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
Example:

"en"

Body

application/json

Default structure of an Employee Interaction.

​
external_id
string<uuid>
required

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

Minimum string length: 1
Pattern: [a-zA-Z0-9_-]+
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

​
interaction_type
string
required

Type of the Employee Interaction.

Example:

"vacancy_liked"

​
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.

Example:

"2025-05-02"

​
vacancy_id
string<uuid>

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

Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

​
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.

Example:

"mechanical engineer"

Response

No Content