Content & Structure

Themes - Knowledge Graphs

The theme must be created first because it will gather the concepts to consolidate. In the API, it is called a knowledge graph:

Method : POST​

URL : HOST_URL/instances/{instance_id}/knowledge_graphs

Json input example:

{​

"name" : "Course title",​

"uid": "your_theme_id"

}

info

A more detailed documentation on how to setup Knowledge Graphs can be found here - Link

---

Concepts to Consolidate - Knowledge Nodes

A concept to consolidate is called a knowledge node by the API.

Method : POST​

URL : HOST_URL/instances/{instance_id}/knowledge_nodes

They must be related to an existing theme (i.e. a knowledge graph). Here is a json input example:

{​

"name": "Chapter 1",

"knowledge_graph_id": 1 , ​

"uid": "your_concept_id"

}

info

A more detailed documentation on how to setup Knowledge Nodes can be found here - Link

---

Questions - Content

A question is a Content with the type « Evaluation ». To create a question you can use the following route:

Method : POST​

URL : HOST_URL/instances/{instance_id}/contents

​ JSON input example:

{​

"name": "My new content",

"uid": "your_question_id",

"content_url": "https://your_url/contents/1",

"type": "Evaluation",

}

Actions - Content

An action is a Content with the type « Action ». To create an action you can use the same route, with the following JSON input:

{​

"name": "My new content",

"uid": "your_action_id",

"content_url": "https://your_url/contents/1",

"type": "Action",

}

info

A more detailed documentation on how to setup Contents can be found here - Link

---

Tagging Contents

Each content can be tagged with a specific filter of your choice. To do so, you will need to create a TagSet and Tag objects:

Method : POST​

URL : HOST_URL/instances/{instance_id}/tag_sets

Method : POST​

URL : HOST_URL/instances/{instance_id}/tags

You will then be able to tag your contents when creating them :

JSON input example:

{​

"name": "My new content",

"uid": "your_question_id",

"tag_set_uid": "your_tag_set_uid"

}

info

A more detailed documentation on how to setup Tags & TagSets can be found here - Link

---

Link Contents to Concepts

Once a content is created, it can be related to a concept to consolidate. In other words, we want to create a link between a knowledge node and a content.

Method : POST​

URL : HOST_URL/instances/{instance_id}/knowledge_node_contents

Json input example:

{​

"content_id": 1,​

"knowledge_node_id": 1 ​

}​

info

A more detailed documentation on how to setup Knowledge Node Contents can be found here - Link