Skip to main content
Create Skill
curl --request POST \
  --url https://{tenant_name}.{region}.techwolf.ai/taxonomy/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "skill_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
  "skill_name": "Machine Learning",
  "skill_description": "SQL is a standard database query language. The Skill \"SQL\" requires the ability to write and execute SQL queries.",
  "properties": {
    "sap_status": {
      "value": "active"
    }
  }
}'
This response does not have an example.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
external_vendor
enum<string>

The external vendor vocabulary in which the input Skills exist. This will only work for vendors that are activated on your tenant. If not passed, the input Skills have to be in the TechWolf vocabulary.

Available options:
workday,
sap_attribute_library
Example:

"workday"

Body

application/json

Default structure for a Skill.

​
skill_id
string<uuid>
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"

​
skill_name
string
required

Name of the Skill.

Required string length: 1 - 255
Example:

"Machine Learning"

​
skill_description
string

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

Example:

"SQL is a standard database query language. The Skill \"SQL\" requires the ability to write and execute SQL queries."

​
properties
object | null

Skill Properties give additional information about the Skill. These properties are the same over all occurrences of the Skill.

Example:
{ "sap_status": { "value": "active" } }

Response

No Content

⌘I