Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt

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

​
User configuration

Store and retrieve per-user configuration for your Cognee Cloud tenant. POST /api/v1/configuration/store_user_configuration — Store a configuration object. GET /api/v1/configuration/get_user_configuration/{config_id} — Retrieve a specific configuration by ID. GET /api/v1/configuration/get_user_configuration/ — Retrieve all configurations for the authenticated user.

​
Ontologies

Ontologies define the structural schema for knowledge graph extraction. They specify which entity types and relationships Cognee should look for during cognify. See Ontologies for the underlying concept. GET /api/v1/ontologies — List uploaded ontologies. POST /api/v1/ontologies — Upload an ontology file. 
curl -X POST https://your-tenant.aws.cognee.ai/api/v1/ontologies \
  -H "X-Api-Key: your-key" \
  -F "ontology_key=my_domain_ontology" \
  -F "ontology_file=@my_ontology.owl" \
  -F "description=Domain ontology for entity extraction"
ParameterTypeRequiredDescription
ontology_keystringyesUser-defined identifier for this ontology
ontology_filefileyesOntology file (OWL format)
descriptionstringnoHuman-readable description
DELETE /api/v1/ontologies/{ontology_key} — Delete an uploaded ontology by key. 
curl -X DELETE https://your-tenant.aws.cognee.ai/api/v1/ontologies/my_domain_ontology \
  -H "X-Api-Key: your-key"
On success, returns: 
{"status": "success", "ontology_key": "my_domain_ontology"}
Status codeMeaning
200Ontology deleted successfully
400ontology_key not found
500Internal error (filesystem)
Ontologies are optional. Without one, Cognee uses its default extraction pipeline. Define an ontology when you need domain-specific entity types or relationships.