---
title: "Update Settings"
method: PATCH
path: "/v1/settings"
tags: ["settings"]
---

# Update Settings

`PATCH /v1/settings`

Persist and apply runtime setting toggles.

Each provided flag 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.

## Request body

- UpdateSettingsRequest — Toggle one or more runtime settings. Omitted fields are left unchanged.
  - `default_pricing` boolean, nullable
  - `model_discovery` boolean, nullable

## Response `200`

Successful Response

- GatewaySettings — Operator-facing runtime settings surfaced to the dashboard.
  - `default_pricing` boolean, required
  - `mode` string, required
  - `model_discovery` boolean, required
  - `require_pricing` boolean, required
  - `version` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-17** `db57bd46e3eb` — 1 info
  - endpoint added
- **2026-04-17** `0f43605bdc13` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/mozilla-ai/apis/otari/changes/v1/settings/patch.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/57a38fb88fa7/schema)