Skip to main content
POST
/
api
/
v1
/
projects
curl -X POST https://api.intellibase.dev/api/v1/projects \
  -H "Authorization: Bearer ib-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Knowledge Base",
    "ontology_id": "ont-abc123"
  }'

{
  "project_id": "proj-abc123",
  "name": "Engineering Knowledge Base",
  "mode": "kg_vector",
  "created_at": "2024-01-15T10:30:00Z",
  "ontology": {
    "name": "Software Engineering",
    "hierarchy": [ ... ],
    "edge_types": [ ... ]
  }
}

​
Endpoint

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

​
Authentication

Requires a valid API key.

​
Request Body

​
name
string
required
Descriptive name for your project
​
vector_only
boolean
default:false
  • true: Vector-Only mode (no knowledge graph, semantic search only)
  • false: KG+Vector mode (requires ontology_id)
​
ontology_id
string
Required if vector_only is false. The ID of an existing ontology.

​
Response

​
project_id
string
Unique identifier for the created project
​
name
string
Project name
​
mode
string
Operating mode: vector_only or kg_vector
​
created_at
string
When the project was created
​
ontology
object
The ontology schema (null for Vector-Only projects)
​
config
object
Project configuration
curl -X POST https://api.intellibase.dev/api/v1/projects \
  -H "Authorization: Bearer ib-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Knowledge Base",
    "ontology_id": "ont-abc123"
  }'

{
  "project_id": "proj-abc123",
  "name": "Engineering Knowledge Base",
  "mode": "kg_vector",
  "created_at": "2024-01-15T10:30:00Z",
  "ontology": {
    "name": "Software Engineering",
    "hierarchy": [ ... ],
    "edge_types": [ ... ]
  }
}
Save the project_id! You’ll need it for all ingestion and query operations.
Projects cannot change modes after creation. Create a new project if you need a different mode.