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

# Update Tool Settings

`PATCH /v1/tool-settings`

Persist and apply tool/guardrail setting changes.

Uses ``model_fields_set`` so an explicit ``null`` clears a field while an
omitted field is left unchanged. Master-key gated and standalone-only.

## Request body

- UpdateToolSettingsRequest — Change one or more tool settings. Omitted fields are left unchanged; an explicit ``null`` clears a field back to the configured env/YAML default.
  - `guardrails_url` string, nullable
  - `sandbox_purpose_hint` string, nullable
  - `sandbox_url` string, nullable
  - `web_search_engines` string, nullable
  - `web_search_extract` boolean, nullable
  - `web_search_intercept` boolean, nullable
  - `web_search_max_results` integer, nullable
  - `web_search_purpose_hint` string, nullable
  - `web_search_url` string, nullable

## Response `200`

Successful Response

- ToolSettingsResponse — The effective value of every editable tool/guardrail field.
  - `fields` ToolSettingField[], required
    - `description` string, nullable
    - `key` string, required
    - `service` 'web_search' | 'sandbox' | 'guardrails', required
    - `type` 'url' | 'str' | 'int' | 'bool', required
    - `value` union, required
      - boolean
      - integer
      - string

## Other responses

- `422` — Validation Error

---

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