curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/job_architecture/job_families/{job_family_external_id}/skill_profile \
  --header 'Authorization: Bearer <token>'
{
  "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "skills": [
    {
      "skill": "Machine Learning",
      "skill_id": "ac3a733e-b258-438d-8d39-9a2837a10e11",
      "skill_types": [
        {
          "skill_type": "Family-Specific"
        }
      ],
      "domain_name": "Data Science",
      "validation_state": "initially_validated",
      "source_data": [
        {
          "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
          "source_data_type": "job_family_profile_data"
        },
        {
          "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
          "source_data_type": "job_profile_data"
        }
      ],
      "proficiency_level": 2,
      "proficiency_float": 0.66,
      "critical": null
    },
    {
      "skill": "Python",
      "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
      "skill_types": [
        {
          "skill_type": "Family-Specific"
        }
      ],
      "domain_name": "Data Science",
      "validation_state": "validated",
      "source_data": [
        {
          "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
          "source_data_type": "job_family_profile_data"
        },
        {
          "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
          "source_data_type": "job_profile_data"
        }
      ],
      "proficiency_level": null,
      "proficiency_float": null,
      "critical": true
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
job_family_external_id
string
required

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

Required string length: 1 - 100
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.

Available options:
en,
en_uk,
en_us,
de,
fr,
nl
​
external_vendor
enum<string>

The external vendor language you want to see the Skills displayed in. This will only work for vendors that are activated on your tenant. When specified, the query parameter include=skill_validation_state will not work, as it is not supported on external vendor Skill Profiles.

Available options:
workday
Example:

"workday"

​
response_format
enum<string>
default:list

Defines the format of the returned Skill Profile.

Available options:
list,
hierarchy
Example:

"list"

​
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,
proficiency_level,
proficiency_float,
critical

Response

200
application/json
OK

The default Skill Profile result is returned. The profile consists of a list of Skills with their Domain names and Skill types.

​
external_id
string
required

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

Required string length: 1 - 100
Example:

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

​
skills
object[]
required

The Skills contained in this profile.

Default structure for an individual Skill.

Example:
[
  {
    "skill": "Machine Learning",
    "skill_id": "ac3a733e-b258-438d-8d39-9a2837a10e11",
    "skill_types": [{ "skill_type": "Family-Specific" }],
    "domain_name": "Data Science",
    "validation_state": "initially_validated",
    "source_data": [
      {
        "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
        "source_data_type": "job_family_profile_data"
      },
      {
        "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
        "source_data_type": "job_profile_data"
      }
    ],
    "proficiency_level": 2,
    "proficiency_float": 0.66,
    "critical": null
  },
  {
    "skill": "Python",
    "skill_id": "4b85469d-6729-4d70-9876-a0faa2a2f63b",
    "skill_types": [{ "skill_type": "Family-Specific" }],
    "domain_name": "Data Science",
    "validation_state": "validated",
    "source_data": [
      {
        "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
        "source_data_type": "job_family_profile_data"
      },
      {
        "external_id": "61a6e076-d780-11ec-9d64-0242ac120002",
        "source_data_type": "job_profile_data"
      }
    ],
    "proficiency_level": null,
    "proficiency_float": null,
    "critical": true
  }
]

Was this page helpful?