---
title: "Update Model Config"
method: PUT
path: "/api/user/model/config"
---

# Update Model Config

`PUT /api/user/model/config`

Update server-level LLM model configuration.

NOTE: In single-tenant (OSS) mode, all authenticated users are
effectively admins and can modify these settings. The premium layer
adds role-based guards via AdminConfigGuardMiddleware to restrict
this to admin users only.

## Request body

- ModelConfigUpdate
  - `llm_provider` string, nullable
  - `llm_model` string, nullable
  - `llm_api_base` string, nullable
  - `vision_model` string, nullable
  - `vision_provider` string, nullable
  - `heartbeat_model` string, nullable
  - `heartbeat_provider` string, nullable
  - `compaction_model` string, nullable
  - `compaction_provider` string, nullable
  - `reasoning_effort` string, nullable

## Response `200`

Successful Response

- ModelConfigResponse
  - `llm_provider` string, required
  - `llm_model` string, required
  - `llm_api_base` string, nullable, required
  - `vision_model` string, required
  - `vision_provider` string, required
  - `heartbeat_model` string, required
  - `heartbeat_provider` string, required
  - `compaction_model` string, required
  - `compaction_provider` string, required
  - `reasoning_effort` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/clawbolt.md) · [All operations](https://skmtc.net/mozilla-ai/apis/clawbolt/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/clawbolt/versions/327e305858ac/schema)