curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/suggestions/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "employee_ids": [
    "a3903505-eb84-42dc-a79f-5e7b1fe897b7"
  ]
}'
{
  "suggestions": [
    {
      "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"
          ]
        }
      ]
    }
  ],
  "validated": [
    {
      "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"
          ]
        }
      ]
    }
  ],
  "rejected": [
    {
      "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
            }
          ]
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
language
enum<string>[]

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.

​
suggestion_count
integer

The maximum number of suggested Skills to be returned and displayed within each Employee's Skill Profile.

Required range: x >= 1
​
max_skills_per_cluster
integer

The maximum number of Skills to return for each Skill Cluster. This only applies when response_format is set to skill_clusters.

Required range: x >= 1
​
external_vendor
enum<string>

The external vendor vocabulary 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.

Available options:
workday
Example:

"workday"

​
include
enum<string>[]

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.

Example:
["suggested_skills"]

Body

application/json

Response

200
application/json

OK

The response is of type object.