curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/{employee_external_id}/skill_events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "event_type": "working_history",
  "timestamp": "2023-12-25",
  "source": "employee-archives",
  "content": {
    "start_date": "2018-09-05",
    "end_date": "2020-06-17",
    "company": "TechWolf BV",
    "job_title": "HR Manager",
    "job_description": "Manage the HR department and perform workforce planning"
  }
}'
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 a Skill Event.

​
external_id
string
required

The unique Skill Event ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
​
event_type
enum<string>
required

Type of the Skill Event. Learn more about the Skill Event Types at <u>How it works</u>.

Available options:
working_history,
education_history,
resume_document,
learning,
feedback,
goal,
project,
ticket,
certificate,
skill_notes
​
timestamp
required

The completion date (in IS08601 format) of the Skill Event. From this point on, the Employee is considered to have obtained the Skills of this Event.

​
content
object
required

The content of the Skill Event. Each type of Skill Event has a different content. The content should align with the event_type. Expanding this field shows you the supported Skill Event content bodies.

​
source
string

The source system of the Skill Event. This is used to keep track of where Skill Events originate from.

Was this page helpful?

List Skill Events of an Employee by event typeGet a Skill Event