v51

OpenAPI 3.1.0raw.githubusercontent.com2026-08-018486293.2 KB

settings

Update Settings

Persist and apply runtime setting changes.

Each provided field is stored as an override (winning over config/env) and applied to the running gateway immediately. Master-key gated: these change how the gateway meters and lists models.

patch/v1/settings

Request body

budget_estimate_default_output_tokensinteger nullable

default_pricingboolean nullable

file_understanding_enabledboolean nullable

model_cache_ttl_secondsinteger nullable

model_discoveryboolean nullable

model_discovery_negative_ttl_secondsnumber nullable

model_discovery_timeout_secondsnumber nullable

models_dev_cache_ttl_secondsinteger nullable

models_dev_metadataboolean nullable

reject_user_mismatchboolean nullable

require_pricingboolean nullable

stream_missing_usage_policy'estimate' | 'fail' | 'allow_free' nullable

vision_describe_max_tokensinteger nullable

vision_describe_modelstring nullable

vision_strategy'describe' | 'ocr' | 'off' nullable

Response

Successful Response

default_pricingboolean required

master_key_source'configured' | 'generated' required

Whether the dashboard master key is configured at startup or generated and stored by Otari.

modestring required

model_discoveryboolean required

require_pricingboolean required

secret_key_configuredboolean required

Whether OTARI_SECRET_KEY is set on the server. Provider credentials are encrypted at rest with it, so the dashboard disables adding stored providers when it is unset.

versionstring required