ontologies

Upload Ontology

Upload a single ontology file for later use in cognify operations. ## Request Parameters - **ontology_key** (str): Unique, user-defined identifier for the ontology (plain string — values starting with '[' or '{' are rejected; duplicate keys return 400). Use this key later as the `ontology_key` parameter in /api/v1/cognify or /api/v1/remember. - **ontology_file** (UploadFile): Single ontology file in OWL (RDF/XML) format; the filename must end with .owl. - **description** (Optional[str]): Optional description for the ontology (plain string; values starting with '[' or '{' are rejected). ## Response Returns metadata about the uploaded ontology including key, filename, size, and upload timestamp. ## Error Codes - **400 Bad Request**: Invalid file format, duplicate key, multiple files uploaded - **500 Internal Server Error**: File system or processing errors

POST

api

ontologies

Upload Ontology

curl --request POST \
  --url https://api.cognee.ai/api/v1/ontologies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'ontology_key=<string>' \
  --form 'ontology_file=<string>'

import requests

url = "https://api.cognee.ai/api/v1/ontologies"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ontology_key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ontology_file\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

ontology_key

string

required

Unique, user-defined identifier for this ontology. Reference it later via the ontology_key parameter of the cognify/remember endpoints.

Example:

"medical_ontology"

ontology_file

string

required

Single ontology file in OWL (RDF/XML) format. The filename must end with .owl — other extensions are rejected with 400. Exactly one file per request.

description

string | null

Optional human-readable description (plain string; values starting with '[' or '{' are rejected).

Example:

"OWL ontology of medical conditions and treatments"

Response

Successful Response

The response is of type Response Upload Ontology Api V1 Ontologies Post · object.

Delete OntologyDelete an uploaded ontology by key. ## Path Parameters - **ontology_key** (str): The key of the ontology to delete. ## Error Codes - **400 Bad Request**: Ontology key not found - **500 Internal Server Error**: File system errors

⌘I

Upload Ontology

curl --request POST \
  --url https://api.cognee.ai/api/v1/ontologies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'ontology_key=<string>' \
  --form 'ontology_file=<string>'

import requests

url = "https://api.cognee.ai/api/v1/ontologies"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ontology_key\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"ontology_file\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Getting Started

auth

add

cognify

memify

search

permissions

datasets

ontologies

settings

visualize

schema

skills

configuration

delete

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

Upload Ontology

Authorizations

Body

Response