curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/taxonomy/skills/{skill_id} \
  --header 'Authorization: Bearer <token>'
{
  "skill_id": "c8c4b3a1-2d55-4dde-a71c-d7129c675a77",
  "skill_name": "SQL",
  "skill_description": "SQL is a standard database query language.The Skill \\\"SQL\\\" requires the ability to write and execute SQL queries.",
  "domain_name": "Information Technology"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
skill_id
required

The universal unique ID of the Skill, consisting of alphanumeric characters, hyphens and underscores. The Skill name connected to this id can be identified by either using the Skill Search endpoint or in any response body that contains that Skill.

Required string length: 1 - 100
Example:

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

Query Parameters

​
include
enum<string>[]

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

Available options:
custom_properties,
adoption
​
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
​
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
​
external_vendor
enum<string>

The external vendor vocabulary you want to get the Skill from. This only works for vendors that are activated on your tenant. Except for skill_name, other query parameters will not work, as they are not supported on external vendor Skills.

Available options:
workday
Example:

"workday"

​
skill_name
string

The external vendor's name of the Skill you want to get. Only works when the external_vendor query parameter is specified.

Required string length: 1 - 100

Response

200
application/json
OK

Default structure for a Skill.

​
skill_id
string
required

The universal unique ID of the Skill, consisting of alphanumeric characters, hyphens and underscores. The Skill name connected to this id can be identified by either using the Skill Search endpoint or in any response body that contains that Skill.

Required string length: 1 - 100
Example:

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

​
skill_name
string
required

Name of the Skill.

Required string length: 1 - 255
Example:

"Python"

​
skill_description
string
required

Description of the Skill. If a custom description is provided, it will be returned; otherwise, the default description from TechWolf is returned.

Example:

"Python is a high-level programming language with an intuitive syntax and a versatile standard library.The Skill \\\"Python\\\" requires the ability to write code in the Python programming language."

​
domain_name
string
required

The Domain name of the Skill.

Minimum length: 1
​
skill_adoption
object

Was this page helpful?