Export Employee Skill Profile data
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/export/employees/skill_profiles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "limit": 10,
  "starting_after": "4cbdbabe-5644-4423-8157-520f8a2f429a",
  "filters": [
    {
      "filter": "is_active",
      "is_active": true
    }
  ],
  "include": [
    "skill_validation_state",
    "sources",
    "rejected_skills",
    "low_data_availability_flag"
  ],
  "output_skills_sorting": "alphabetical"
}'
{
"has_next": true,
"records": [
{
"external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
"num_skill_events": 2,
"low_data_availability": false,
"seniority": 4.290482248178559,
"skills": [
{
"skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
"skill": "Python",
"validation_state": "suggested",
"sources": [
"education_history"
],
"source_events": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"event_type": "education_history",
"source": "workday"
}
],
"self_rated_proficiency_level": 2,
"self_rated_proficiency_float": 0.4,
"inferred_proficiency_level": 5,
"inferred_proficiency_float": 1
},
{
"skill_id": "267d511f-26d4-4c84-b2ae-eae89627deba",
"skill": "Unit Testing",
"validation_state": "suggested",
"sources": [
"working_history"
],
"source_events": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"event_type": "working_history",
"source": "workday"
}
],
"self_rated_proficiency_level": 2,
"self_rated_proficiency_float": 0.4,
"inferred_proficiency_level": 3,
"inferred_proficiency_float": 0.6
}
]
}
],
"next_starting_after": "61a6e076-d780-11ec-9d64-0242ac120007"
}

Authorizations

Authorization
string
header
required

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

Query Parameters

response_format
enum<string>
default:list

Defines the format of the returned Skill Profile.

Available options:
list,
hierarchy
Example:

"list"

external_vendor
enum<string>

The external vendor vocabulary you want to see the Skills displayed in. This will only work for vendors that are activated on your tenant.

Available options:
workday
Example:

"workday"

Body

application/json
limit
integer
required

The number of Employees shown on a single page.

Required range: 1 <= x <= 100
Example:

10

starting_after
string

The external_id of the Employee to continue looking from.

Maximum length: 100
Example:

"4cbdbabe-5644-4423-8157-520f8a2f429a"

filters
(is_active · object | last_updated · object)[]

A set of filters to apply on the exported Employees.

include
enum<string>[]

Expand the results with extra data.

Example:
[
"skill_validation_state",
"sources",
"rejected_skills",
"low_data_availability_flag"
]
output_skills_sorting
enum<string>
default:alphabetical

Sort the Skills in the results alphabetically or by decreasing confidence. This has no effect when an external vendor is specified.

Available options:
alphabetical,
confidence
Example:

"alphabetical"

Response

OK

has_next
boolean
required

True when there is more data after this page.

Example:

true

records
(List · object | Hierarchy · object)[]
required

A list containing the requested data for each entity, limited by the limit parameter.

next_starting_after
string

The next starting_after value for pagination.

Maximum length: 100
Example:

"5cbdbdbe-5f44-4423-8157-520f8a2f429a"