Get the suggestions Skill Profile for selected Employees
This endpoint retrieves Skill suggestions for selected Employees. Users can customize the response with optional query parameters like language, the number of suggestions, and the format (Skill Profiles or Skill Clusters). It supports filtering by Skill types (suggested, validated, rejected). The response includes detailed Skill suggestions, with translated names and sources, and optional clustering if selected.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
The display languages for which Skill names are provided.
If not specified, the default language (en_uk
) will be used.
The en
language is an alias for en_uk
.
en
, en_uk
, en_us
, de
, fr
, nl
The maximum number of suggested Skills to be returned and displayed within each Employee's Skill Profile.
x >= 1
The maximum number of Skills to return for each Skill Cluster.
This only applies when response_format
is set to skill_clusters
.
x >= 1
The external vendor language in which you want the skill suggestions to be returned. This will only work for vendors that are activated on your tenant. If no external vendor is specified, skills will be returned in the TechWolf vocabulary.
workday
"workday"
The type of suggestions to include in the response.
suggested_skills
- Include the suggested Skills in the response.
validated_skills
- Include the validated Skills in the response.
rejected_skills
- Include the rejected Skills in the response.
suggested_skills
, validated_skills
, rejected_skills
["suggested_skills"]
Body
The IDs of the Employees for which to get the suggestions. Maximum of 50 Employees.
The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.
Response
An array containing Skill suggestions for the requested Employees.
[
{
"employee_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"skills": [
{
"skill_id": "95747a9e-57e7-4892-967d-37e6c126e35e",
"skill_names": [
{
"language": "en_uk",
"skill_name": "Python",
"translation_found": true
},
{
"language": "nl",
"skill_name": "Python",
"translation_found": true
},
{
"language": "pt",
"skill_name": null,
"translation_found": false
}
],
"sources": ["education_history"]
},
{
"skill_id": "6b665a95-dba8-4f76-85d7-a4669da01c26",
"skill_names": [
{
"language": "en_uk",
"skill_name": "Programming",
"translation_found": true
},
{
"language": "nl",
"skill_name": "Programmeren",
"translation_found": true
},
{
"language": "pt",
"skill_name": null,
"translation_found": false
}
],
"sources": ["education_history"]
}
]
}
]
An array containing validated Skill suggestions for the requested Employees.
[
{
"employee_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"skills": [
{
"skill_id": "81fcc471-cef7-448d-824c-2e2ebf1ce8be",
"skill_names": [
{
"language": "en_uk",
"skill_name": "Agile Development",
"translation_found": true
},
{
"language": "nl",
"skill_name": "Agile Ontwikkeling",
"translation_found": true
},
{
"language": "pt",
"skill_name": null,
"translation_found": false
}
],
"sources": ["education_history"]
},
{
"skill_id": "7d34b72e-7ca5-45fd-80e0-8ed7e615ee53",
"skill_names": [
{
"language": "en_uk",
"skill_name": "Automated Testing",
"translation_found": true
},
{
"language": "nl",
"skill_name": "Geautomatiseerd Testen",
"translation_found": true
},
{
"language": "pt",
"skill_name": null,
"translation_found": false
}
],
"sources": ["education_history"]
}
]
}
]
An array containing rejected Skill suggestions for the requested Employees.
[
{
"employee_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"skills": [
{
"skill_id": "6843733c-e646-4a77-ae70-c0da60618ffe",
"skill_names": [
{
"language": "en_uk",
"skill_name": "Business Requirement Analysis",
"translation_found": true
},
{
"language": "nl",
"skill_name": "Analyse Van Bedrijfsvereisten",
"translation_found": true
},
{
"language": "pt",
"skill_name": null,
"translation_found": false
}
]
}
]
}
]
Was this page helpful?