Skip to main content
POST
/
api
/
v1
/
ontologies
curl -X POST https://api.intellibase.dev/api/v1/ontologies \
  -H "Authorization: Bearer ib-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Software Engineering",
    "schema": {
      "ontology": {
        "hierarchy": [
          {
            "level": 0,
            "node_types": {
              "Developer": {
                "properties": ["name", "role", "team"],
                "description": "Software developer"
              },
              "Feature": {
                "properties": ["name", "status", "deadline"],
                "description": "Software feature"
              }
            }
          }
        ],
        "edge_types": [
          {
            "name": "WORKS_ON",
            "source_types": ["Developer"],
            "target_types": ["Feature"],
            "properties": ["role"],
            "temporal": true,
            "description": "Developer works on feature"
          }
        ]
      }
    }
  }'

{
  "id": "ont-abc123",
  "name": "Software Engineering",
  "created_at": "2024-01-15T10:30:00Z",
  "schema": {
    "ontology": {
      "hierarchy": [ ... ],
      "edge_types": [ ... ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.intellibase.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST https://api.intellibase.dev/api/v1/ontologies

​
Authentication

Requires a valid API key.

​
Request Body

​
name
string
required
Descriptive name for the ontology (e.g., “Software Engineering”, “Customer Support”)
​
schema
object
required
Ontology schema definition including hierarchy and edge types

​
Response

​
id
string
Unique identifier for the ontology
​
name
string
The ontology name
​
created_at
string
When the ontology was created
​
schema
object
The complete ontology schema
curl -X POST https://api.intellibase.dev/api/v1/ontologies \
  -H "Authorization: Bearer ib-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Software Engineering",
    "schema": {
      "ontology": {
        "hierarchy": [
          {
            "level": 0,
            "node_types": {
              "Developer": {
                "properties": ["name", "role", "team"],
                "description": "Software developer"
              },
              "Feature": {
                "properties": ["name", "status", "deadline"],
                "description": "Software feature"
              }
            }
          }
        ],
        "edge_types": [
          {
            "name": "WORKS_ON",
            "source_types": ["Developer"],
            "target_types": ["Feature"],
            "properties": ["role"],
            "temporal": true,
            "description": "Developer works on feature"
          }
        ]
      }
    }
  }'

{
  "id": "ont-abc123",
  "name": "Software Engineering",
  "created_at": "2024-01-15T10:30:00Z",
  "schema": {
    "ontology": {
      "hierarchy": [ ... ],
      "edge_types": [ ... ]
    }
  }
}
Use the Suggest Ontology endpoint to get an AI-generated starting point!