Overview

Settings

Settings provide multi-level configuration with inheritance from defaults through global to workspace-specific overrides.

Settings Hierarchy

Defaults → Global → Workspace

Each level overrides the previous, allowing flexible configuration.

Settings Categories

Category	Description
model_defaults	Default LLM provider and model
rag	Chunk size, overlap, retrieval settings
agent	Agent behavior and prompts
display	UI preferences
notifications	Alert and notification settings

Resolved Settings

Get the final computed settings for a workspace:

GET /api/workspaces/{id}/settings/resolved

This returns the merged result of all configuration levels.

Example Configuration

{
  "model_defaults": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "temperature": 0.7
  },
  "rag": {
    "chunk_size": 1000,
    "chunk_overlap": 200,
    "top_k": 10
  }
}