omni-settings

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

SKILL.md

GitHub
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

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

Get application settings

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

PATCH /api/settings

Update settings

curl -X PATCH https://localhost:20128/api/settings \
  -H "Authorization: Bearer $NEXTROUTE_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 $NEXTROUTE_TOKEN"

PUT /api/settings/compression

Update global compression settings

curl -X PUT https://localhost:20128/api/settings/compression \
  -H "Authorization: Bearer $NEXTROUTE_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 $NEXTROUTE_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 $NEXTROUTE_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 $NEXTROUTE_TOKEN"

GET /api/settings/proxy

Get proxy settings

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

PATCH /api/settings/proxy

Update proxy settings

curl -X PATCH https://localhost:20128/api/settings/proxy \
  -H "Authorization: Bearer $NEXTROUTE_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 $NEXTROUTE_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 $NEXTROUTE_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 $NEXTROUTE_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 $NEXTROUTE_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 $NEXTROUTE_TOKEN"

PUT /api/settings/system-prompt

Update system prompt configuration

curl -X PUT https://localhost:20128/api/settings/system-prompt \
  -H "Authorization: Bearer $NEXTROUTE_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 $NEXTROUTE_TOKEN"

PUT /api/settings/thinking-budget

Update thinking budget configuration

curl -X PUT https://localhost:20128/api/settings/thinking-budget \
  -H "Authorization: Bearer $NEXTROUTE_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 $NEXTROUTE_TOKEN"

Payloads

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