---
title: "Set the preferred model"
method: POST
path: "/workspaces/{id}/config/model"
tags: ["config"]
---

# Set the preferred model

`POST /workspaces/{id}/config/model`

## Path parameters

- `id` string, required

## Request body

- ProtoConfigModelRequest
  - `model` ConfigSelectedModel
    - `frequency_penalty` number
    - `max_tokens` integer — Overrides the default model configuration.
    - `model` string — The model id as used by the provider API. Required.
    - `presence_penalty` number
    - `provider` string — The model provider, same as the key/id used in the providers config. Required.
    - `provider_options` object — Override provider specific options.
    - `reasoning_effort` string — Only used by models that use the openai provider and need this set.
    - `temperature` number
    - `think` boolean — Used by anthropic models that can reason to indicate if the model should think.
    - `top_k` integer
    - `top_p` number
  - `model_type` 'large' | 'small'
  - `scope` 0 | 1

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/charmbracelet/apis/crush-api.md) · [All operations](https://skmtc.dev/charmbracelet/apis/crush-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/charmbracelet/crush-api/revisions/81bee9ef86c6/schema)