Skip to main content
POST
/
api
/
v1
/
ontologies
/
suggest
curl -X POST https://api.intellibase.dev/api/v1/ontologies/suggest \
  -H "Authorization: Bearer ib-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "usecase": "Track customer support tickets, agents, customers, and resolutions. Include ticket categories, priority levels, and customer satisfaction ratings."
  }'
{
  "name": "Customer Support Ontology",
  "schema": {
    "ontology": {
      "hierarchy": [
        {
          "level": 0,
          "node_types": {
            "Ticket": {
              "properties": ["title", "priority", "status", "satisfaction_rating"],
              "description": "Customer support ticket"
            },
            "Agent": {
              "properties": ["name", "specialization", "active"],
              "description": "Support agent"
            },
            "Customer": {
              "properties": ["name", "tier", "email"],
              "description": "Customer who filed ticket"
            }
          }
        },
        {
          "level": 1,
          "node_types": {
            "Category": {
              "aggregates": ["Ticket"],
              "properties": ["name", "description"],
              "description": "Ticket category or topic area"
            }
          }
        }
      ],
      "edge_types": [
        {
          "name": "ASSIGNED_TO",
          "source_types": ["Ticket"],
          "target_types": ["Agent"],
          "properties": ["assigned_date"],
          "temporal": true,
          "description": "Ticket assigned to agent"
        },
        {
          "name": "FILED_BY",
          "source_types": ["Ticket"],
          "target_types": ["Customer"],
          "properties": [],
          "temporal": false,
          "description": "Ticket filed by customer"
        },
        {
          "name": "BELONGS_TO_CATEGORY",
          "source_types": ["Ticket"],
          "target_types": ["Category"],
          "properties": [],
          "temporal": false,
          "description": "Ticket categorization"
        }
      ]
    }
  }
}

Endpoint

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

Authentication

Requires a valid API key.

Request Body

usecase
string
required
Description of your use case or domain. Be specific about the entities, relationships, and concepts you want to track.

Response

Returns an ontology specification in the same format as the Create Ontology request body.
name
string
AI-generated name for the ontology
schema
object
Complete ontology schema ready to be used in Create Ontology
curl -X POST https://api.intellibase.dev/api/v1/ontologies/suggest \
  -H "Authorization: Bearer ib-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "usecase": "Track customer support tickets, agents, customers, and resolutions. Include ticket categories, priority levels, and customer satisfaction ratings."
  }'
{
  "name": "Customer Support Ontology",
  "schema": {
    "ontology": {
      "hierarchy": [
        {
          "level": 0,
          "node_types": {
            "Ticket": {
              "properties": ["title", "priority", "status", "satisfaction_rating"],
              "description": "Customer support ticket"
            },
            "Agent": {
              "properties": ["name", "specialization", "active"],
              "description": "Support agent"
            },
            "Customer": {
              "properties": ["name", "tier", "email"],
              "description": "Customer who filed ticket"
            }
          }
        },
        {
          "level": 1,
          "node_types": {
            "Category": {
              "aggregates": ["Ticket"],
              "properties": ["name", "description"],
              "description": "Ticket category or topic area"
            }
          }
        }
      ],
      "edge_types": [
        {
          "name": "ASSIGNED_TO",
          "source_types": ["Ticket"],
          "target_types": ["Agent"],
          "properties": ["assigned_date"],
          "temporal": true,
          "description": "Ticket assigned to agent"
        },
        {
          "name": "FILED_BY",
          "source_types": ["Ticket"],
          "target_types": ["Customer"],
          "properties": [],
          "temporal": false,
          "description": "Ticket filed by customer"
        },
        {
          "name": "BELONGS_TO_CATEGORY",
          "source_types": ["Ticket"],
          "target_types": ["Category"],
          "properties": [],
          "temporal": false,
          "description": "Ticket categorization"
        }
      ]
    }
  }
}
Review before creating! The AI-generated ontology is a starting point. Review and modify it to match your specific needs before creating it.
Be specific in your use case description for better results:
  • ✅ Good: “Track software projects, developers, features, and deadlines. Include team hierarchies and feature dependencies.”
  • ❌ Too vague: “Track my work stuff”
The suggestion endpoint uses LLM calls and may take around 30 seconds to complete.