Skip to main content

​
Get config

curl http://localhost:6877/config \
  -H "Authorization: Bearer $API_KEY"

{
  "chat_model": "claude-sonnet-4-6",
  "research_model": "claude-sonnet-4-6",
  "memory_model": "claude-sonnet-4-6",
  "embedding_model": "text-embedding-3-small",
  "integrations": {
    "google": {"enabled": true, "connected": true},
    "memory": {"enabled": true, "connected": true, "dreams": false},
    "web": {"connected": true, "mode": "auto", "provider": "ddgs"}
  }
}

​
Update config

curl -X PATCH http://localhost:6877/config \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chat_model": "gpt-5.2"}'

​
Models

​
List chat/research/memory models

curl http://localhost:6877/models \
  -H "Authorization: Bearer $API_KEY"
Returns models grouped by provider.

​
List embedding models

curl http://localhost:6877/models/embedding \
  -H "Authorization: Bearer $API_KEY"

​
Change embedding model

Changing the embedding model triggers a full re-index of memory: 
curl -X POST http://localhost:6877/config/embedding \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"embedding_model": "text-embedding-3-large"}'

​
Add custom model

Register an OpenAI-compatible model endpoint: 
curl -X POST http://localhost:6877/models/custom \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "my-model",
    "base_url": "http://localhost:11434/v1",
    "context_window": 128000,
    "max_output_tokens": 8192,
    "api_key": "optional-key"
  }'

​
Remove custom model

curl -X DELETE http://localhost:6877/models/custom/my-model \
  -H "Authorization: Bearer $API_KEY"

​
Providers

​
List providers

curl http://localhost:6877/providers \
  -H "Authorization: Bearer $API_KEY"
Returns all providers (Anthropic, OpenAI, OpenAI Codex, Google, OpenRouter, Custom) with connection status, available models, auth type, and masked API key hints.

​
Connect provider

curl -X POST http://localhost:6877/providers/openai/connect \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key": "sk-...", "chat_model": "gpt-5.2"}'
OpenAI Codex uses browser OAuth instead of an API-key connect request: 
curl -X POST http://localhost:6877/providers/openai-codex/oauth/browser/start \
  -H "Authorization: Bearer $API_KEY"
Poll status while the browser flow is pending: 
curl http://localhost:6877/providers/openai-codex/oauth/status \
  -H "Authorization: Bearer $API_KEY"

​
Disconnect provider

curl -X DELETE http://localhost:6877/providers/openai \
  -H "Authorization: Bearer $API_KEY"

​
Services

External service integrations (Exa web search, Telegram).

​
List services

curl http://localhost:6877/services \
  -H "Authorization: Bearer $API_KEY"

​
Connect service

curl -X POST http://localhost:6877/services/telegram/connect \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_key": "bot-token..."}'

​
Disconnect service

curl -X DELETE http://localhost:6877/services/telegram \
  -H "Authorization: Bearer $API_KEY"

​
Notifiers

Notifier configuration lives in the automation router. See Notifiers for /notifiers/* endpoints.

​
Directives

System directives customize the agent’s behavior. They persist across sessions and are injected into the system prompt.

​
Get directives

curl http://localhost:6877/directives \
  -H "Authorization: Bearer $API_KEY"

​
Update directives

curl -X PUT http://localhost:6877/directives \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Always respond in Spanish. Be concise."}'

​
Context

​
Get token usage

curl http://localhost:6877/context \
  -H "Authorization: Bearer $API_KEY"

​
Compact context

Compress conversation history to free token space: 
curl -X POST http://localhost:6877/compact \
  -H "Authorization: Bearer $API_KEY"