Overview

Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

• GET /api/settings/memory
• PUT /api/settings/memory
• GET /api/settings/qdrant
• PUT /api/settings/qdrant
• GET /api/settings/qdrant/health
• POST /api/settings/qdrant/search
• POST /api/settings/qdrant/cleanup
• GET /api/settings/qdrant/embedding-models
• GET /api/settings
• PATCH /api/settings
• POST /api/settings/purge-request-history
• GET /api/settings/compression
• PUT /api/settings/compression
• GET /api/settings/compression/mcp-accessibility
• PUT /api/settings/compression/mcp-accessibility
• GET /api/settings/payload-rules
• PUT /api/settings/payload-rules
• GET /api/settings/combo-defaults
• GET /api/settings/proxy
• PATCH /api/settings/proxy
• POST /api/settings/proxy/test
• POST /api/settings/require-login
• GET /api/settings/ip-filter
• PUT /api/settings/ip-filter
• GET /api/settings/pii
• PUT /api/settings/pii
• POST /api/settings/pii/test
• GET /api/settings/system-prompt
• PUT /api/settings/system-prompt
• GET /api/settings/thinking-budget
• PUT /api/settings/thinking-budget
• GET /api/tags
• GET /api/settings/quota-store
• PUT /api/settings/quota-store
• POST /api/settings/purge-usage-history
• GET /api/settings/authz-inventory
• GET /api/settings/auto-disable-accounts
• PUT /api/settings/auto-disable-accounts
• GET /api/settings/background-degradation
• POST /api/settings/background-degradation
• PUT /api/settings/background-degradation
• GET /api/settings/cache-config
• PUT /api/settings/cache-config
• GET /api/settings/cache-metrics
• DELETE /api/settings/cache-metrics
• GET /api/settings/cc-discovery-metrics
• GET /api/settings/compression/rules
• GET /api/settings/compression/run-telemetry
• GET /api/settings/database
• PUT /api/settings/database
• PATCH /api/settings/database
• POST /api/settings/database/integrity-check
• POST /api/settings/database/refresh-stats
• GET /api/settings/database/vacuum
• POST /api/settings/database/vacuum
• GET /api/settings/export-json
• GET /api/settings/favicon
• GET /api/settings/feature-flags
• PUT /api/settings/feature-flags
• DELETE /api/settings/feature-flags
• GET /api/settings/free-proxies
• DELETE /api/settings/free-proxies
• POST /api/settings/free-proxies/{id}/add-to-pool
• POST /api/settings/free-proxies/bulk-add-to-pool
• GET /api/settings/free-proxies/stats
• POST /api/settings/free-proxies/sync
• POST /api/settings/import-json
• DELETE /api/settings/lkgp-cache
• GET /api/settings/local-corpus
• POST /api/settings/local-corpus
• DELETE /api/settings/local-corpus
• GET /api/settings/mitm
• POST /api/settings/mitm
• PUT /api/settings/mitm
• GET /api/settings/model-aliases
• POST /api/settings/model-aliases
• PUT /api/settings/model-aliases
• DELETE /api/settings/model-aliases
• GET /api/settings/models-dev
• POST /api/settings/models-dev
• GET /api/settings/notion
• POST /api/settings/notion
• DELETE /api/settings/notion
• GET /api/settings/obsidian
• POST /api/settings/obsidian
• DELETE /api/settings/obsidian
• GET /api/settings/obsidian/webdav
• POST /api/settings/obsidian/webdav
• DELETE /api/settings/obsidian/webdav
• GET /api/settings/oneproxy
• POST /api/settings/oneproxy
• DELETE /api/settings/oneproxy
• POST /api/settings/oneproxy/rotate
• GET /api/settings/proxies
• POST /api/settings/proxies
• PATCH /api/settings/proxies
• DELETE /api/settings/proxies
• POST /api/settings/proxies/{id}/repair-relay
• GET /api/settings/proxies/assignments
• PUT /api/settings/proxies/assignments
• POST /api/settings/proxies/auto-test
• POST /api/settings/proxies/batch-activate
• POST /api/settings/proxies/batch-delete
• PUT /api/settings/proxies/bulk-assign
• POST /api/settings/proxies/bulk-import
• GET /api/settings/proxies/egress
• POST /api/settings/proxies/egress
• GET /api/settings/proxies/health
• POST /api/settings/proxies/migrate
• GET /api/settings/proxies/pool
• PUT /api/settings/proxies/pool
• PATCH /api/settings/proxies/pool
• DELETE /api/settings/proxies/pool
• GET /api/settings/proxies/pool/egress-observation
• POST /api/settings/proxy/cloudflare-deploy
• POST /api/settings/proxy/deno-deploy
• POST /api/settings/proxy/vercel-deploy
• POST /api/settings/purge-call-logs
• POST /api/settings/purge-detailed-logs
• POST /api/settings/purge-logs
• POST /api/settings/purge-quota-snapshots
• GET /api/settings/quota/state
• POST /api/settings/quota/state
• GET /api/settings/reasoning-routing-rules
• POST /api/settings/reasoning-routing-rules
• GET /api/settings/reasoning-routing-rules/{id}
• PATCH /api/settings/reasoning-routing-rules/{id}
• DELETE /api/settings/reasoning-routing-rules/{id}
• POST /api/settings/reasoning-routing-rules/simulate
• GET /api/settings/task-routing
• POST /api/settings/task-routing
• PUT /api/settings/task-routing
• GET /api/settings/tier-config
• PUT /api/settings/tier-config
• GET /api/settings/transfer/catalog
• POST /api/settings/transfer/export
• POST /api/settings/transfer/preview
• POST /api/settings/transfer/import

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

GET /api/settings/thinking-budget — behavior

Returns proxy-level thinking/reasoning request rewrite settings:

Not compression and not "decrypt encrypted reasoning". Full guide: docs/guides/THINKING_BUDGET.md.

Example — keep client-controlled reasoning (Codex/Desktop):

curl -X PUT https://localhost:20128/api/settings/thinking-budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"passthrough","customBudget":10240,"effortLevel":"medium"}'

Warning: mode=auto deletes reasoning / reasoning_effort / Claude thinking from the outbound body before upstream. That can empty thinking panels even when the client requested Ultra + summary.