settings

Save Settings

Save or update system settings.

This endpoint allows updating the system configuration settings. You can update either the LLM configuration, vector database configuration, or both. Only provided settings will be updated; others remain unchanged.

Request Parameters

llm (Optional[LLMConfigInputDTO]): LLM configuration (provider, model, API key)
vector_db (Optional[VectorDBConfigInputDTO]): Vector database configuration (provider, URL, API key)

Response

No content returned on successful save.

Error Codes

400 Bad Request: Invalid settings provided
500 Internal Server Error: Error saving settings

POST

api

settings

Save Settings

curl --request POST \
  --url https://api.cognee.ai/api/v1/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "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

application/json

llm

LLMConfigInputDTO · object | null

Show child attributes

vectorDb

VectorDBConfigInputDTO · object | null

Show child attributes

Response

Successful Response

VisualizeGenerate an HTML visualization of the dataset's knowledge graph. This endpoint creates an interactive HTML visualization of the knowledge graph for a specific dataset. The visualization displays nodes and edges representing entities and their relationships, allowing users to explore the graph structure visually. ## Query Parameters - **dataset_id** (UUID): The unique identifier of the dataset to visualize ## Response Returns an HTML page containing the interactive graph visualization. ## Error Codes - **409 Conflict**: Dataset not found, permission denied, or visualization failed (detail in the `error` field) ## Notes - User must have read permissions on the dataset - Visualization is interactive and allows graph exploration

⌘I

Save Settings

curl --request POST \
  --url https://api.cognee.ai/api/v1/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

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