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": "SQL",
  "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"
    }
  }
}
'
[
  {
    "title": "400 Bad Request",
    "description": "The request body was not structured correctly."
  }
]

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. This should be provided in the default language (en_uk). To add translations, use the Update Skill endpoint.

Required string length: 1 - 255
Example:

"SQL"

​
skill_description
string

Description of the Skill. This should be provided in the default language (en_uk). To add translations, use the Update Skill endpoint.

Minimum string length: 1
Example:

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

​
properties
object

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