Version: Next

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