omni-settings

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

Get memory settings

Returns the extended memory settings including 7 new fields added in plan 21 (embeddingSource, embeddingProviderModel, transformersEnabled, staticEnabled, rerankEnabled, rerankProviderModel, vectorStore).

curl https://localhost:20128/api/settings/memory \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/memory

Update memory settings

Update any subset of the extended memory settings. All fields are optional; only provided fields are updated. Schema: MemorySettingsExtendedSchema.

curl -X PUT https://localhost:20128/api/settings/memory \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/qdrant

Get Qdrant settings

Returns current Qdrant configuration. The apiKey field is never returned raw — use hasApiKey / apiKeyMasked instead.

curl https://localhost:20128/api/settings/qdrant \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/qdrant

Update Qdrant settings

Update Qdrant configuration. Pass apiKey: "" to remove the stored key. Schema: QdrantSettingsUpdateSchema.

curl -X PUT https://localhost:20128/api/settings/qdrant \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/qdrant/health

Qdrant health probe

Performs a liveness check against the configured Qdrant instance. Returns latency and any connection error (sanitized — no stack traces).

curl https://localhost:20128/api/settings/qdrant/health \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/qdrant/search

Qdrant semantic search test

Performs a test semantic search against the Qdrant collection. Useful for validating that the integration works end-to-end. Schema: QdrantSearchSchema.

curl -X POST https://localhost:20128/api/settings/qdrant/search \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/qdrant/cleanup

Clean up expired Qdrant points

Removes Qdrant points for memories that have expired or exceeded the configured retention window.

curl -X POST https://localhost:20128/api/settings/qdrant/cleanup \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/qdrant/embedding-models

List Qdrant embedding models

Returns the list of embedding models available for use with Qdrant.

curl https://localhost:20128/api/settings/qdrant/embedding-models \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings

Get application settings

curl https://localhost:20128/api/settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PATCH /api/settings

Update settings

curl -X PATCH https://localhost:20128/api/settings \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/purge-request-history

Clear request log history

Deletes call_logs, legacy request_detail_logs, and local request artifact files under DATA_DIR/call_logs.

curl -X POST https://localhost:20128/api/settings/purge-request-history \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/compression

Get global compression settings

curl https://localhost:20128/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/compression

Update global compression settings

curl -X PUT https://localhost:20128/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/compression/mcp-accessibility

Get the MCP tool-output accessibility (trimming) config

curl https://localhost:20128/api/settings/compression/mcp-accessibility \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/compression/mcp-accessibility

Update the MCP tool-output accessibility (trimming) config

Partial-merge update. Numeric floors (e.g. a maxTextChars below the truncation-tail reserve) are folded back to the safe defaults server-side, so the response reflects the effective config.

curl -X PUT https://localhost:20128/api/settings/compression/mcp-accessibility \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/payload-rules

Get payload rules configuration

Returns the current payload rules used to mutate outgoing request payloads before they are sent upstream.

Requires a dashboard management session cookie when management auth is enabled.

curl https://localhost:20128/api/settings/payload-rules \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/payload-rules

Update payload rules configuration

Persists and hot reloads payload rules. The legacy input field default-raw is accepted on writes and normalized to defaultRaw in responses/runtime state.

Requires a dashboard management session cookie when management auth is enabled.

curl -X PUT https://localhost:20128/api/settings/payload-rules \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/combo-defaults

Get combo default settings

curl https://localhost:20128/api/settings/combo-defaults \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/proxy

Get proxy settings

curl https://localhost:20128/api/settings/proxy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PATCH /api/settings/proxy

Update proxy settings

curl -X PATCH https://localhost:20128/api/settings/proxy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxy/test

Test proxy connection

curl -X POST https://localhost:20128/api/settings/proxy/test \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/require-login

Toggle login requirement

curl -X POST https://localhost:20128/api/settings/require-login \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/ip-filter

Get IP filter configuration

Returns the current IP filter settings including blacklist, whitelist, and temp bans.

curl https://localhost:20128/api/settings/ip-filter \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/ip-filter

Update IP filter configuration

Configure IP filtering with blacklist/whitelist modes, add/remove individual IPs, and manage temp bans.

curl -X PUT https://localhost:20128/api/settings/ip-filter \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/system-prompt

Get system prompt configuration

Returns the current system prompt injection settings.

curl https://localhost:20128/api/settings/system-prompt \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/system-prompt

Update system prompt configuration

curl -X PUT https://localhost:20128/api/settings/system-prompt \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/thinking-budget

Get thinking budget configuration

Returns the current thinking/reasoning budget settings for AI models.

curl https://localhost:20128/api/settings/thinking-budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/thinking-budget

Update thinking budget configuration

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

GET /api/tags

List Ollama-compatible model tags

Returns models in Ollama /api/tags format for Ollama client compatibility

curl https://localhost:20128/api/tags \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/quota-store

Get current quota store driver settings

Redis URL is masked in the response (shows only scheme+host).

curl https://localhost:20128/api/settings/quota-store \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/quota-store

Update quota store driver settings

curl -X PUT https://localhost:20128/api/settings/quota-store \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/purge-usage-history

Purge usage history

Dashboard-only. Purges stored usage-history records.

curl -X POST https://localhost:20128/api/settings/purge-usage-history \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/authz-inventory

GET settings › authz inventory

curl https://localhost:20128/api/settings/authz-inventory \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/auto-disable-accounts

GET settings › auto disable accounts

curl https://localhost:20128/api/settings/auto-disable-accounts \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/auto-disable-accounts

PUT settings › auto disable accounts

curl -X PUT https://localhost:20128/api/settings/auto-disable-accounts \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/background-degradation

GET settings › background degradation

curl https://localhost:20128/api/settings/background-degradation \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/background-degradation

POST settings › background degradation

curl -X POST https://localhost:20128/api/settings/background-degradation \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/settings/background-degradation

PUT settings › background degradation

curl -X PUT https://localhost:20128/api/settings/background-degradation \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/cache-config

GET settings › cache config

curl https://localhost:20128/api/settings/cache-config \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/cache-config

PUT settings › cache config

curl -X PUT https://localhost:20128/api/settings/cache-config \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/cache-metrics

GET settings › cache metrics

curl https://localhost:20128/api/settings/cache-metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

DELETE /api/settings/cache-metrics

DELETE settings › cache metrics

curl -X DELETE https://localhost:20128/api/settings/cache-metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/cc-discovery-metrics

GET settings › cc discovery metrics

curl https://localhost:20128/api/settings/cc-discovery-metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/compression/rules

GET settings › compression › rules

curl https://localhost:20128/api/settings/compression/rules \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/compression/run-telemetry

GET settings › compression › run telemetry

curl https://localhost:20128/api/settings/compression/run-telemetry \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/database

GET settings › database

curl https://localhost:20128/api/settings/database \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/database

PUT settings › database

curl -X PUT https://localhost:20128/api/settings/database \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PATCH /api/settings/database

PATCH settings › database

curl -X PATCH https://localhost:20128/api/settings/database \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/database/refresh-stats

POST settings › database › refresh stats

curl -X POST https://localhost:20128/api/settings/database/refresh-stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/database/vacuum

GET settings › database › vacuum

curl https://localhost:20128/api/settings/database/vacuum \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/database/vacuum

POST settings › database › vacuum

curl -X POST https://localhost:20128/api/settings/database/vacuum \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/export-json

GET settings › export json

curl https://localhost:20128/api/settings/export-json \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/favicon

GET settings › favicon

curl https://localhost:20128/api/settings/favicon \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/feature-flags

GET settings › feature flags

curl https://localhost:20128/api/settings/feature-flags \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/feature-flags

PUT settings › feature flags

curl -X PUT https://localhost:20128/api/settings/feature-flags \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/feature-flags

DELETE settings › feature flags

curl -X DELETE https://localhost:20128/api/settings/feature-flags \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/free-proxies

GET settings › free proxies

curl https://localhost:20128/api/settings/free-proxies \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

DELETE /api/settings/free-proxies

DELETE settings › free proxies

curl -X DELETE https://localhost:20128/api/settings/free-proxies \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/free-proxies/{id}/add-to-pool

POST settings › free proxies › › add to pool

curl -X POST https://localhost:20128/api/settings/free-proxies/{id}/add-to-pool \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/free-proxies/bulk-add-to-pool

POST settings › free proxies › bulk add to pool

curl -X POST https://localhost:20128/api/settings/free-proxies/bulk-add-to-pool \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/free-proxies/stats

GET settings › free proxies › stats

curl https://localhost:20128/api/settings/free-proxies/stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/free-proxies/sync

POST settings › free proxies › sync

curl -X POST https://localhost:20128/api/settings/free-proxies/sync \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/import-json

POST settings › import json

curl -X POST https://localhost:20128/api/settings/import-json \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/lkgp-cache

DELETE settings › lkgp cache

curl -X DELETE https://localhost:20128/api/settings/lkgp-cache \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/local-corpus

GET settings › local corpus

curl https://localhost:20128/api/settings/local-corpus \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/local-corpus

POST settings › local corpus

curl -X POST https://localhost:20128/api/settings/local-corpus \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/local-corpus

DELETE settings › local corpus

curl -X DELETE https://localhost:20128/api/settings/local-corpus \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/mitm

GET settings › mitm

curl https://localhost:20128/api/settings/mitm \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/mitm

POST settings › mitm

curl -X POST https://localhost:20128/api/settings/mitm \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/settings/mitm

PUT settings › mitm

curl -X PUT https://localhost:20128/api/settings/mitm \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/model-aliases

GET settings › model aliases

curl https://localhost:20128/api/settings/model-aliases \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/model-aliases

POST settings › model aliases

curl -X POST https://localhost:20128/api/settings/model-aliases \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/settings/model-aliases

PUT settings › model aliases

curl -X PUT https://localhost:20128/api/settings/model-aliases \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/model-aliases

DELETE settings › model aliases

curl -X DELETE https://localhost:20128/api/settings/model-aliases \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/models-dev

GET settings › models dev

curl https://localhost:20128/api/settings/models-dev \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/models-dev

POST settings › models dev

curl -X POST https://localhost:20128/api/settings/models-dev \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/notion

GET settings › notion

curl https://localhost:20128/api/settings/notion \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/notion

POST settings › notion

curl -X POST https://localhost:20128/api/settings/notion \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/notion

DELETE settings › notion

curl -X DELETE https://localhost:20128/api/settings/notion \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/obsidian

GET settings › obsidian

curl https://localhost:20128/api/settings/obsidian \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/obsidian

POST settings › obsidian

curl -X POST https://localhost:20128/api/settings/obsidian \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/obsidian

DELETE settings › obsidian

curl -X DELETE https://localhost:20128/api/settings/obsidian \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/obsidian/webdav

GET settings › obsidian › webdav

curl https://localhost:20128/api/settings/obsidian/webdav \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/obsidian/webdav

POST settings › obsidian › webdav

curl -X POST https://localhost:20128/api/settings/obsidian/webdav \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/obsidian/webdav

DELETE settings › obsidian › webdav

curl -X DELETE https://localhost:20128/api/settings/obsidian/webdav \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/oneproxy

GET settings › oneproxy

curl https://localhost:20128/api/settings/oneproxy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/oneproxy

POST settings › oneproxy

curl -X POST https://localhost:20128/api/settings/oneproxy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/oneproxy

DELETE settings › oneproxy

curl -X DELETE https://localhost:20128/api/settings/oneproxy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/oneproxy/rotate

POST settings › oneproxy › rotate

curl -X POST https://localhost:20128/api/settings/oneproxy/rotate \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/proxies

GET settings › proxies

curl https://localhost:20128/api/settings/proxies \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/proxies

POST settings › proxies

curl -X POST https://localhost:20128/api/settings/proxies \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PATCH /api/settings/proxies

PATCH settings › proxies

curl -X PATCH https://localhost:20128/api/settings/proxies \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/proxies

DELETE settings › proxies

curl -X DELETE https://localhost:20128/api/settings/proxies \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/proxies/{id}/repair-relay

POST settings › proxies › › repair relay

curl -X POST https://localhost:20128/api/settings/proxies/{id}/repair-relay \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/proxies/assignments

GET settings › proxies › assignments

curl https://localhost:20128/api/settings/proxies/assignments \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/proxies/assignments

PUT settings › proxies › assignments

curl -X PUT https://localhost:20128/api/settings/proxies/assignments \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxies/auto-test

POST settings › proxies › auto test

curl -X POST https://localhost:20128/api/settings/proxies/auto-test \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxies/batch-activate

POST settings › proxies › batch activate

curl -X POST https://localhost:20128/api/settings/proxies/batch-activate \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxies/batch-delete

POST settings › proxies › batch delete

curl -X POST https://localhost:20128/api/settings/proxies/batch-delete \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/settings/proxies/bulk-assign

PUT settings › proxies › bulk assign

curl -X PUT https://localhost:20128/api/settings/proxies/bulk-assign \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxies/bulk-import

POST settings › proxies › bulk import

curl -X POST https://localhost:20128/api/settings/proxies/bulk-import \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/proxies/egress

GET settings › proxies › egress

curl https://localhost:20128/api/settings/proxies/egress \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/proxies/egress

POST settings › proxies › egress

curl -X POST https://localhost:20128/api/settings/proxies/egress \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/proxies/health

GET settings › proxies › health

curl https://localhost:20128/api/settings/proxies/health \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/proxies/migrate

POST settings › proxies › migrate

curl -X POST https://localhost:20128/api/settings/proxies/migrate \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/proxies/pool

GET settings › proxies › pool

curl https://localhost:20128/api/settings/proxies/pool \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/proxies/pool

PUT settings › proxies › pool

curl -X PUT https://localhost:20128/api/settings/proxies/pool \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PATCH /api/settings/proxies/pool

PATCH settings › proxies › pool

curl -X PATCH https://localhost:20128/api/settings/proxies/pool \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/proxies/pool

DELETE settings › proxies › pool

curl -X DELETE https://localhost:20128/api/settings/proxies/pool \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/settings/proxies/pool/egress-observation

GET settings › proxies › pool › egress observation

Read-only observation of how many distinct egress IPs actually served the members of a proxy pool over the last 24 h, read from the proxy log (numbers only, never used for routing). Opt-in through the PROXY_POOL_EGRESS_OBSERVATION feature flag: while it is off, or when the read fails, the body is JSON null. Results are cached for 30 seconds per normalized scope (key is read as account, global as the stored global pool).

curl https://localhost:20128/api/settings/proxies/pool/egress-observation \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/proxy/cloudflare-deploy

POST settings › proxy › cloudflare deploy

curl -X POST https://localhost:20128/api/settings/proxy/cloudflare-deploy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxy/deno-deploy

POST settings › proxy › deno deploy

curl -X POST https://localhost:20128/api/settings/proxy/deno-deploy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/proxy/vercel-deploy

POST settings › proxy › vercel deploy

curl -X POST https://localhost:20128/api/settings/proxy/vercel-deploy \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/purge-call-logs

POST settings › purge call logs

curl -X POST https://localhost:20128/api/settings/purge-call-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/purge-detailed-logs

POST settings › purge detailed logs

curl -X POST https://localhost:20128/api/settings/purge-detailed-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/purge-logs

POST settings › purge logs

curl -X POST https://localhost:20128/api/settings/purge-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/settings/purge-quota-snapshots

POST settings › purge quota snapshots

curl -X POST https://localhost:20128/api/settings/purge-quota-snapshots \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/quota/state

GET settings › quota › state

curl https://localhost:20128/api/settings/quota/state \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/quota/state

POST settings › quota › state

curl -X POST https://localhost:20128/api/settings/quota/state \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/reasoning-routing-rules

GET settings › reasoning routing rules

curl https://localhost:20128/api/settings/reasoning-routing-rules \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/reasoning-routing-rules

POST settings › reasoning routing rules

curl -X POST https://localhost:20128/api/settings/reasoning-routing-rules \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/reasoning-routing-rules/{id}

GET settings › reasoning routing rules ›

curl https://localhost:20128/api/settings/reasoning-routing-rules/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PATCH /api/settings/reasoning-routing-rules/{id}

PATCH settings › reasoning routing rules ›

curl -X PATCH https://localhost:20128/api/settings/reasoning-routing-rules/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/settings/reasoning-routing-rules/{id}

DELETE settings › reasoning routing rules ›

curl -X DELETE https://localhost:20128/api/settings/reasoning-routing-rules/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/reasoning-routing-rules/simulate

POST settings › reasoning routing rules › simulate

curl -X POST https://localhost:20128/api/settings/reasoning-routing-rules/simulate \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/task-routing

GET settings › task routing

curl https://localhost:20128/api/settings/task-routing \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/settings/task-routing

POST settings › task routing

curl -X POST https://localhost:20128/api/settings/task-routing \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

PUT /api/settings/task-routing

PUT settings › task routing

curl -X PUT https://localhost:20128/api/settings/task-routing \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/settings/tier-config

GET settings › tier config

curl https://localhost:20128/api/settings/tier-config \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

PUT /api/settings/tier-config

PUT settings › tier config

curl -X PUT https://localhost:20128/api/settings/tier-config \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

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.