About omni-settings
omni-settings provides authenticated API endpoints for reading and changing OmniRoute's global application settings. It covers configuration areas from prompts and reasoning budgets to proxies, databases, and feature flags.
Key features
- 01Read and update global settings
- 02Configure system prompts and reasoning budgets
- 03Manage proxy and IP-filter settings
- 04Inspect and configure database options
- 05Export and import settings
Use cases
- 01Adjust application settings through the API
- 02Configure reasoning request rewriting
- 03Manage proxy and access-filter configuration
- 04Transfer settings between configurations
MCP support
The README describes API settings for MCP accessibility and compression, but does not specify an MCP server or client interface.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ cheaper-inference/ omniroute --skill omni-settingsAfter installing, type/omni-settingsin Claude Code to confirm it loaded.
Bundled filesreferences/endpoints.md
Details
From the project READMEOverview
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.