​
Adding Skill Clusters

The essential first step of any flow with the Skill Engine API is creating the Entities within the system.

For example, to create a Skill Cluster you can simply submit a POST request to /taxonomy/skill_clusters:

{
  "external_id": "CP-001",
  "skill_cluster_name": "Data Science Modelling",
  "skill_cluster_description": "The ability to use machine learning algorithms to extract value from data"
}

The sequence diagram below shows the communication steps:

After the initial creation, the Skill Clusters can be updated by sending a PATCH request to /taxonomy/skill_clusters/CP-001. More information can be found at the endpoint specification .

The lifecycle of each Entity is managed explicitly, meaning that you cannot overwrite an existing Entity with a POST message. To update an Entity, you can execute a PATCH call at its specific endpoint.