Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ntrp.io/llms.txt

Use this file to discover all available pages before exploring further.

​
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, Google, OpenRouter, Custom) with connection status, available models, 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"}'

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

​
Notifier configs

Notifiers deliver automation results to external channels.

​
List configs

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

​
List available types

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

​
Create notifier

curl -X POST http://localhost:6877/notifiers/configs \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-telegram", "type": "telegram", "config": {"chat_id": "123456"}}'

​
Test notifier

curl -X POST http://localhost:6877/notifiers/configs/my-telegram/test \
  -H "Authorization: Bearer $API_KEY"

​
Delete notifier

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

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