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.

Available options:
en,
en_uk,
en_us,
de,
fr,
nl
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 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.

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.

Available options:
suggested_skills,
validated_skills,
rejected_skills
Example:
["suggested_skills"]

Body

application/json
employee_ids
string[]
required

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

200
application/json
OK
suggestions
object[]

An array containing Skill suggestions for the requested Employees.

Example:
[
  {
    "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
object[]

An array containing validated Skill suggestions for the requested Employees.

Example:
[
  {
    "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
object[]

An array containing rejected Skill suggestions for the requested Employees.

Example:
[
  {
    "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
          }
        ]
      }
    ]
  }
]