Get the suggested Skill Profile for a Job

curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "skills": [
    {
      "skill": "Machine Learning",
      "skill_id": "ac3a733e-b258-438d-8d39-9a2837a10e11",
      "skill_type": "Job-Specific",
      "domain_name": "Data Science",
      "validation_state": "suggested",
      "source_data": [
        {
          "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
          "source_data_type": "job_profile_data"
        },
        {
          "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
          "source_data_type": "job_profile_data"
        }
      ],
      "critical": true
    },
    {
      "skill": "Python",
      "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
      "skill_type": "Core",
      "domain_name": "Programming",
      "validation_state": "validated",
      "source_data": [
        {
          "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
          "source_data_type": "job_profile_data"
        },
        {
          "external_id": "12a6e076-d780-11ec-9d64-0242ac120002",
          "source_data_type": "job_family_profile_data"
        }
      ],
      "critical": false
    }
  ]
}

Get the suggested Skill Profile for a Job

curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant_name}.{region}.techwolf.ai/job_architecture/jobs/{job_external_id}/suggested_skill_profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "skills": [
    {
      "skill": "Machine Learning",
      "skill_id": "ac3a733e-b258-438d-8d39-9a2837a10e11",
      "skill_type": "Job-Specific",
      "domain_name": "Data Science",
      "validation_state": "suggested",
      "source_data": [
        {
          "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
          "source_data_type": "job_profile_data"
        },
        {
          "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
          "source_data_type": "job_profile_data"
        }
      ],
      "critical": true
    },
    {
      "skill": "Python",
      "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
      "skill_type": "Core",
      "domain_name": "Programming",
      "validation_state": "validated",
      "source_data": [
        {
          "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
          "source_data_type": "job_profile_data"
        },
        {
          "external_id": "12a6e076-d780-11ec-9d64-0242ac120002",
          "source_data_type": "job_family_profile_data"
        }
      ],
      "critical": false
    }
  ]
}

Authorizations

Authorization

string

header

required

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

Path Parameters

job_external_id

string<uuid>

required

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

Required string length: 1 - 100

Pattern: [a-zA-Z0-9_-]+

Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

Query Parameters

domain_namespace

enum<string>

default:techwolf

The Domain namespace determines the Domains the Skills will be mapped to. Using techwolf will map them to the default TechWolf domains. Using taxonomy will map them to the custom Domains defined in your Taxonomy. Using adaptive will map the Skills to the Domains in the custom Taxonomy if there is one present, otherwise it will fall back to the default Techwolf Domains.

Available options:

techwolf,

taxonomy,

adaptive

vocab_language

enum<string>

default:en_uk

The display language used for Skill names. Altering the vocabulary language does not change the Skill Profile; it solely changes the way it is displayed. If not specified, the default language (en_uk) will be used. The en language is an alias for en_uk. IETF BCP 47 language tags (e.g. fr-FR, zh-CN) are also accepted and mapped to their internal equivalents.

Vendor-specific availability: Only the following languages are available for the default TechWolf vocabulary: en, en_uk, en_us, de, fr, nl. The additional languages (es, fr_ca, it, ja, ko, pt_br, zh_cn, zh_tw, sv, fi, da, no) are only available when the request is scoped to the workday vendor (via external_vendor=workday) and the tenant's Workday vocabulary includes them. Use GET /taxonomy/skills/languages to discover the exact set of languages available for a given vendor in your tenant.

Available options:

en,

en_uk,

en_us,

de,

fr,

nl,

es,

fr_ca,

it,

ja,

ko,

pt_br,

zh_cn,

zh_tw,

sv,

fi,

da,

no

response_format

enum<string>

default:list

Defines the format of the returned Skill Profile.

Available options:

list,

hierarchy

Example:

"list"

external_vendor

enum<string>

default:techwolf

The external vendor vocabulary you want to see the Skills displayed in. This will only work for vendors that are activated on your tenant.

Available options:

techwolf,

workday,

sap_attribute_library

Example:

"workday"

include

enum<string>[]

Additional attributes that will be included in the response body. This query parameter can be added multiple times to include more attributes.

Available options:

skill_validation_state,

critical,

properties

Response

ListSkillProfile
Hierarchy

The default Skill Profile result returned. The profile consists of a list of skills with their domain names and skill types.

external_id

string<uuid>

required

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

Required string length: 1 - 100

Pattern: [a-zA-Z0-9_-]+

Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

skills

object[]

required

The skills contained in this profile.

Show child attributes

Example:

[
  {
    "skill": "Machine Learning",
    "skill_id": "ac3a733e-b258-438d-8d39-9a2837a10e11",
    "skill_type": "Job-Specific",
    "domain_name": "Data Science",
    "validation_state": "suggested",
    "source_data": [
      {
        "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
        "source_data_type": "job_profile_data"
      },
      {
        "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
        "source_data_type": "job_profile_data"
      }
    ],
    "critical": true
  },
  {
    "skill": "Python",
    "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
    "skill_type": "Core",
    "domain_name": "Programming",
    "validation_state": "validated",
    "source_data": [
      {
        "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
        "source_data_type": "job_profile_data"
      },
      {
        "external_id": "12a6e076-d780-11ec-9d64-0242ac120002",
        "source_data_type": "job_family_profile_data"
      }
    ],
    "critical": false
  }
]

API Documentation

API Versioning

AI Integration

Taxonomy

Employees

Job Families

Jobs

Peer Groups

Vacancies

Courses

Skill Clusters

External Companies

Skills

Tasks

Organisational Structure

Custom Properties

Matchmaking

Matching Configuration

Export

Reports

Version

Get the suggested Skill Profile for a Job

Authorizations

Path Parameters

Query Parameters

Response