API Documentation
Taxonomy
- Domains
- Subdomains
- Skill Clusters
- Skills
- Taxonomy operations
Employees
- CRUD
- Skill Profile
- Metrics
- Search
- Skill Events
- Interactions
- Suggestions
Job Families
- CRUD
- Skill Profile
- Job Family Profile Data
Jobs
- CRUD
- Skill Profile
- Job Profile Data
- Metrics
Vacancies
- CRUD
- Skill Profile
- Metrics
- Search
Courses
- CRUD
- Skill Profile
- Metrics
Skill Clusters
- CRUD
- Skill Profile
- Metrics
External Companies
- CRUD
- Search
Skills
- Skill Search
- Skill Gaps
- Skill Lookup
Organisational Structure
- Organisational Units
Custom Properties
- Definitions
- Properties
Matchmaking
- Vacancy Matching
- Course Recommendations
- External Company Matching
- Job Matching
- Job Family Matching
- Match Feedback
Matching Configuration
Export
- Employees
- Job Architecture
- Courses
- Employees Assigned Position
- Taxonomy
- Organisational Structure
Reports
- General Reports
- Employee Reports
- Vacancy Reports
- Job Reports
- Data Maturity Scan
Version
- Version
Export Employee Skill Profile data
Export all Skill Profiles of all Employees by paginating through the data.
The Employees are returned based on their creation time, with those created first being returned first.
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"
}
]
},
{
"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"
}
]
}
]
},
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"num_skill_events": 5,
"low_data_availability": false,
"seniority": 3.389503858602185,
"skills": [
{
"skill_id": "8313fe8a-f39e-4a35-8c82-93b46c3de9bb",
"skill": "Balance Sheet",
"validation_state": "validated",
"sources": [
"education_history"
],
"source_events": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"event_type": "education_history",
"source": "workday"
}
]
},
{
"skill_id": "bdb5ee3f-8ba0-4c40-92b2-0277431ae069",
"skill": "IFRS",
"validation_state": "rejected",
"sources": [
"working_history"
],
"source_events": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"event_type": "working_history",
"source": "workday"
}
]
}
]
}
],
"next_starting_after": "5cbdbdbe-5f44-4423-8157-520f8a2f429a"
}
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
The number of Employees shown on a single page.
1 < x < 100
The external_id
of the Employee to continue looking from.
100
A set of filters to apply on the exported Employees.
Only include entities with the active
attribute set to true
or false
. If the filter is not set, all entities will be included.
is_active
Set to true
to only include entities with the active
attribute set to true
. Set to false
to only include entities with the active
attribute set to false
.
Expand the results with extra data.
skill_validation_state
, sources
, rejected_skills
, low_data_availability_flag
Sort the Skills in the results alphabetically or by decreasing confidence.
alphabetical
, confidence
Response
True when there is more data after this page.
A list containing the requested data for each entity, limited by the limit
parameter.
The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.
1 - 100
The amount of Skill Events an Employee has.
x > 0
List of Skills for the Employee.
ID of the Skill.
Name of the Skill.
This field indicates whether this Skill is already validated or rejected by a manager or Employee or still in the suggested state.
validated
, suggested
, rejected
The Skill Event types from which the Skill was inferred.
The Skill Events from which the Skill was inferred.
The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.
1 - 100
A type of Skill Event.
The source of the Skill Event.
Flag indicating whether sufficient data is available for qualitative skill inference for a given entity.
The next starting_after
value for pagination.
100
Was this page helpful?
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"
}
]
},
{
"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"
}
]
}
]
},
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"num_skill_events": 5,
"low_data_availability": false,
"seniority": 3.389503858602185,
"skills": [
{
"skill_id": "8313fe8a-f39e-4a35-8c82-93b46c3de9bb",
"skill": "Balance Sheet",
"validation_state": "validated",
"sources": [
"education_history"
],
"source_events": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"event_type": "education_history",
"source": "workday"
}
]
},
{
"skill_id": "bdb5ee3f-8ba0-4c40-92b2-0277431ae069",
"skill": "IFRS",
"validation_state": "rejected",
"sources": [
"working_history"
],
"source_events": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"event_type": "working_history",
"source": "workday"
}
]
}
]
}
],
"next_starting_after": "5cbdbdbe-5f44-4423-8157-520f8a2f429a"
}