Store User Configuration

Store (upsert) a named configuration for the authenticated user.

Request Parameters

• name (str): Name of the configuration. If a configuration with the same name already exists for this user, it is updated in place.
• config (dict): JSON-serializable configuration data to store (e.g. a KG schema, LLM settings, or ingestion parameters).

Response

Returns null on success (HTTP 200).

POST /api/v1/configuration/store_user_configuration

Store User Configuration

cURL

curl --request POST \
  --url https://api.cognee.ai/api/v1/configuration/store_user_configuration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "default_llm_settings",
  "config": {
    "chunk_size": 4096,
    "llm_model": "openai/gpt-4o-mini"
  }
}
'

422

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

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

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

Body

application/json

name · string

Name of the configuration to store. If a configuration with this name already exists for the user it is updated in place. Always provide a value: omitting it results in a server error.

Example:

"default_llm_settings"

config · Config · object

The configuration data to store as a JSON object (e.g. a KG schema, LLM settings, or ingestion parameters). Always provide a value: omitting it results in a server error.

Example:

{
  "chunk_size": 4096,
  "llm_model": "openai/gpt-4o-mini"
}

Response

200

application/json

Successful Response