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": [ ... ]
    }
  }
}

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!