Skip to main content
GET
/
taxonomy
/
skill_clusters
List Skill Clusters
curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/taxonomy/skill_clusters \
  --header 'Authorization: Bearer <token>'
{
  "count": 2,
  "results": [
    {
      "external_id": "bc3a5bc9-5f44-4423-8157-520f8a2f429a",
      "skill_cluster_name": "Programming Languages",
      "last_updated": "2023-05-22T13:22:39.179747",
      "skill_cluster_description": "Knowledge of programming languages and their use in software development."
    },
    {
      "external_id": "62d2c013-ab77-410e-b5fb-2f96eed9c1db",
      "skill_cluster_name": "Database Management",
      "last_updated": "2023-05-22T13:22:41.165448",
      "skill_cluster_description": "Knowledge of actions a business takes to manipulate and control data to meet necessary conditions throughout the entire data lifecycle."
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
integer
default:100

The maximal number of entities returned, ordered by the last_updated field and external_id.

Required range: 1 <= x <= 200
Example:

50

​
offset
integer
default:0

The applied offset for returned entities, results starting from offset up to offset + limit.

Required range: x >= 0
​
include
enum<string>[]

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

Available options:
skill_cluster_description,
custom_properties
Example:
[
  "skill_cluster_description",
  "custom_properties"
]

Response

OK

​
count
integer
required

Total number of Skill Cluster entities stored in the system.

Required range: x >= 0
Example:

2

​
results
skill_cluster_content · object[]
required

Subset of Skill Clusters starting from offset up to offset + limit.

Example:
[
  {
    "external_id": "bc3a5bc9-5f44-4423-8157-520f8a2f429a",
    "skill_cluster_name": "Programming Languages",
    "last_updated": "2023-05-22T13:22:39.179747",
    "skill_cluster_description": "Knowledge of programming languages and their use in software development."
  },
  {
    "external_id": "62d2c013-ab77-410e-b5fb-2f96eed9c1db",
    "skill_cluster_name": "Database Management",
    "last_updated": "2023-05-22T13:22:41.165448",
    "skill_cluster_description": "Knowledge of actions a business takes to manipulate and control data to meet necessary conditions throughout the entire data lifecycle."
  }
]