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/memoryPUT /api/settings/memoryGET /api/settings/qdrantPUT /api/settings/qdrantGET /api/settings/qdrant/healthPOST /api/settings/qdrant/searchPOST /api/settings/qdrant/cleanupGET /api/settings/qdrant/embedding-modelsGET /api/settingsPATCH /api/settingsPOST /api/settings/purge-request-historyGET /api/settings/compressionPUT /api/settings/compressionGET /api/settings/compression/mcp-accessibilityPUT /api/settings/compression/mcp-accessibilityGET /api/settings/payload-rulesPUT /api/settings/payload-rulesGET /api/settings/combo-defaultsGET /api/settings/proxyPATCH /api/settings/proxyPOST /api/settings/proxy/testPOST /api/settings/require-loginGET /api/settings/ip-filterPUT /api/settings/ip-filterGET /api/settings/piiPUT /api/settings/piiPOST /api/settings/pii/testGET /api/settings/system-promptPUT /api/settings/system-promptGET /api/settings/thinking-budgetPUT /api/settings/thinking-budgetGET /api/tagsGET /api/settings/quota-storePUT /api/settings/quota-storePOST /api/settings/purge-usage-historyGET /api/settings/authz-inventoryGET /api/settings/auto-disable-accountsPUT /api/settings/auto-disable-accountsGET /api/settings/background-degradationPOST /api/settings/background-degradationPUT /api/settings/background-degradationGET /api/settings/cache-configPUT /api/settings/cache-configGET /api/settings/cache-metricsDELETE /api/settings/cache-metricsGET /api/settings/cc-discovery-metricsGET /api/settings/compression/rulesGET /api/settings/compression/run-telemetryGET /api/settings/databasePUT /api/settings/databasePATCH /api/settings/databasePOST /api/settings/database/integrity-checkPOST /api/settings/database/refresh-statsGET /api/settings/database/vacuumPOST /api/settings/database/vacuumGET /api/settings/export-jsonGET /api/settings/faviconGET /api/settings/feature-flagsPUT /api/settings/feature-flagsDELETE /api/settings/feature-flagsGET /api/settings/free-proxiesDELETE /api/settings/free-proxiesPOST /api/settings/free-proxies/{id}/add-to-poolPOST /api/settings/free-proxies/bulk-add-to-poolGET /api/settings/free-proxies/statsPOST /api/settings/free-proxies/syncPOST /api/settings/import-jsonDELETE /api/settings/lkgp-cacheGET /api/settings/local-corpusPOST /api/settings/local-corpusDELETE /api/settings/local-corpusGET /api/settings/mitmPOST /api/settings/mitmPUT /api/settings/mitmGET /api/settings/model-aliasesPOST /api/settings/model-aliasesPUT /api/settings/model-aliasesDELETE /api/settings/model-aliasesGET /api/settings/models-devPOST /api/settings/models-devGET /api/settings/notionPOST /api/settings/notionDELETE /api/settings/notionGET /api/settings/obsidianPOST /api/settings/obsidianDELETE /api/settings/obsidianGET /api/settings/obsidian/webdavPOST /api/settings/obsidian/webdavDELETE /api/settings/obsidian/webdavGET /api/settings/oneproxyPOST /api/settings/oneproxyDELETE /api/settings/oneproxyPOST /api/settings/oneproxy/rotateGET /api/settings/proxiesPOST /api/settings/proxiesPATCH /api/settings/proxiesDELETE /api/settings/proxiesPOST /api/settings/proxies/{id}/repair-relayGET /api/settings/proxies/assignmentsPUT /api/settings/proxies/assignmentsPOST /api/settings/proxies/auto-testPOST /api/settings/proxies/batch-activatePOST /api/settings/proxies/batch-deletePUT /api/settings/proxies/bulk-assignPOST /api/settings/proxies/bulk-importGET /api/settings/proxies/egressPOST /api/settings/proxies/egressGET /api/settings/proxies/healthPOST /api/settings/proxies/migrateGET /api/settings/proxies/poolPUT /api/settings/proxies/poolPATCH /api/settings/proxies/poolDELETE /api/settings/proxies/poolGET /api/settings/proxies/pool/egress-observationPOST /api/settings/proxy/cloudflare-deployPOST /api/settings/proxy/deno-deployPOST /api/settings/proxy/vercel-deployPOST /api/settings/purge-call-logsPOST /api/settings/purge-detailed-logsPOST /api/settings/purge-logsPOST /api/settings/purge-quota-snapshotsGET /api/settings/quota/statePOST /api/settings/quota/stateGET /api/settings/reasoning-routing-rulesPOST /api/settings/reasoning-routing-rulesGET /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/simulateGET /api/settings/task-routingPOST /api/settings/task-routingPUT /api/settings/task-routingGET /api/settings/tier-configPUT /api/settings/tier-configGET /api/settings/transfer/catalogPOST /api/settings/transfer/exportPOST /api/settings/transfer/previewPOST /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:
| Field | Meaning |
|---|---|
mode |
passthrough (leave client reasoning alone — required for Codex visible thinking), auto (strips all client thinking fields), custom, adaptive |
customBudget |
Fixed budget when mode=custom |
effortLevel |
Base effort when mode=adaptive |
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.