Entities

Entities are the facts from which all other facts hang. Entities by themselves do not have much meaning. You must add information to entities to give them meaning

Example:

POST /createentity
{
    "parentId": "00000000404AE4402DF969ACE2C2DA9133A23EA48773AF8A"
}

The response contains the nodeId of the created entity.

Response
{
    "factType": "Entity",
    "nodeId": "0000000095B596C9F7A4C4A7FAF992383282008B58FAFBB8",
    "parentId": "00000000404AE4402DF969ACE2C2DA9133A23EA48773AF8A",
}

The Data Root Node

Since all facts must ultimately hang off an existing entity node, how does one get the first entity node? To do anything with Factern, you need an login. Off of every login is a special entity node called the Data Root Node. It is from that node you may start creating other nodes.

You can get the Data Root Node, by describing your login using the describe API call.

Example:

POST /describe
{
    "nodeId": "000000003CA0E41E6BC0F5BF2B0DA70B3505CD902ADF9D76"
}

The property dataRootNode of the response is the id of the Data Root Node.

{
    "node": {
        "factType": "Login",
        "nodeId": "000000003CA0E41E6BC0F5BF2B0DA70B3505CD902ADF9D76",
        "dataRootNode": "00000000404AE4402DF969ACE2C2DA9133A23EA48773AF8A",
    }]
}