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://{tenant}.aws.cognee.ai/api/v1/ontologies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form ontology_key=medical_ontology \
  --form ontology_file='@example-file'

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/ontologies"

files = { "ontology_file": ("example-file", open("example-file", "rb")) }
payload = { "ontology_key": "medical_ontology" }
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, 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

file

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.

⌘I

Upload Ontology

curl --request POST \
  --url https://{tenant}.aws.cognee.ai/api/v1/ontologies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form ontology_key=medical_ontology \
  --form ontology_file='@example-file'

import requests

url = "https://{tenant}.aws.cognee.ai/api/v1/ontologies"

files = { "ontology_file": ("example-file", open("example-file", "rb")) }
payload = { "ontology_key": "medical_ontology" }
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, 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

validate

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

slack

integrations

Upload Ontology

Request Parameters

Response

Error Codes

Authorizations

Body

Response