---
title: "Update Model Configuration"
method: PATCH
path: "/v1/model-configurations/{model_configuration_id}"
tags: ["model-configurations"]
---

# Update Model Configuration

`PATCH /v1/model-configurations/{model_configuration_id}`

## Path parameters

- `model_configuration_id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- ModelConfigurationUpdate — Update a model configuration (organization-owned only).
  - `name` string, nullable
  - `description` string, nullable
  - `provider` string, nullable
  - `model` string, nullable
  - `api_key` string, nullable — Raw API key; if provided, replaces the stored alias.
  - `clear_api_key` boolean, nullable — If true, clears any stored api_key_alias (reverts to Cyberdesk-provided key if supported).
  - `temperature` number, nullable
  - `max_tokens` integer, nullable
  - `timeout_seconds` number, nullable
  - `max_retries` integer, nullable
  - `additional_params` object, nullable
  - `agent_harness_version_string` string, nullable
  - `is_computer_use_model` boolean, nullable
  - `is_archived` boolean, nullable

## Response `200`

Successful Response

- ModelConfigurationResponse — API response schema for model configurations.
  - `name` string, required
  - `description` string, nullable
  - `provider` string, required — LangChain provider name (e.g. 'anthropic', 'openai').
  - `model` string, required — Provider model identifier (e.g. 'claude-sonnet-4-5-20250929').
  - `temperature` number, nullable
  - `max_tokens` integer, nullable
  - `timeout_seconds` number, nullable
  - `max_retries` integer, nullable
  - `additional_params` object, nullable — Provider-specific kwargs passed through to LangChain.
  - `agent_harness_version_string` string, nullable — Agent harness version string used by Cyberdesk workers for prompt/tool selection.
  - `is_computer_use_model` boolean — True if this model has native computer use capabilities. If True, can be used for main agent, focused actions, and fallbacks for those agents.
  - `is_archived` boolean — Whether this model configuration is archived and should generally be hidden behind archived-model UI affordances.
  - `id` string, uuid, required
  - `organization_id` string, nullable
  - `api_key_alias` string, nullable — Basis Theory token id (alias) used to resolve api_key at runtime.
  - `is_system_default` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud.md) · [All operations](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberdesk-hq/cyberdesk-cloud/versions/830d2f48963d/schema)