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"
  ],
  "response_format": "skill_profiles"
}'
{
  "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.<br/> 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.<br/> suggested_skills - Include the suggested Skills in the response.<br/> validated_skills - Include the validated Skills in the response.<br/> 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.<br/>

The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

​
response_format
enum<string>
default:skill_profiles

The format in which the suggestions should be returned.<br/> skill_profiles - Return the suggestions as a list of the Employee Skill Profiles.<br/> skill_clusters - Return the suggestions as a list of the Employee Skill Clusters. <br/> If an external_vendor is specified skill_clusters response format will not work, as this is not supported for external vendor skills.

Available options:
skill_profiles,
skill_clusters

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
          }
        ]
      }
    ]
  }
]

Was this page helpful?

Delete Employee InteractionOverview