> ## 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.

# Configuration & Ontologies

> Endpoints for user configuration and ontology management

## 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](/core-concepts/main-operations/legacy-operations/cognify). See [Ontologies](/core-concepts/further-concepts/ontologies) for the underlying concept.

**`GET /api/v1/ontologies`** — List uploaded ontologies.

**`POST /api/v1/ontologies`** — Upload an ontology file.

```bash theme={null}
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"
```

| Parameter       | Type   | Required | Description                               |
| --------------- | ------ | -------- | ----------------------------------------- |
| `ontology_key`  | string | yes      | User-defined identifier for this ontology |
| `ontology_file` | file   | yes      | Ontology file (OWL format)                |
| `description`   | string | no       | Human-readable description                |

**`DELETE /api/v1/ontologies/{ontology_key}`** — Delete an uploaded ontology by key.

```bash theme={null}
curl -X DELETE https://your-tenant.aws.cognee.ai/api/v1/ontologies/my_domain_ontology \
  -H "X-Api-Key: your-key"
```

On success, returns:

```json theme={null}
{"status": "success", "ontology_key": "my_domain_ontology"}
```

| Status code | Meaning                       |
| ----------- | ----------------------------- |
| `200`       | Ontology deleted successfully |
| `400`       | `ontology_key` not found      |
| `500`       | Internal error (filesystem)   |

<Info>
  Ontologies are optional. Without one, Cognee uses its default extraction pipeline. Define an ontology when you need domain-specific entity types or relationships.
</Info>