v1

latestOpenAPI 3.1.02026-07-22136108233.0 KB

model-configurations

Update Model Configuration

patch/v1/model-configurations/{model_configuration_id}

Path parameters

model_configuration_idstring uuid required

Headers

Idempotency-Keystring

Example:550e8400-e29b-41d4-a716-446655440000

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Request body

namestring nullable

descriptionstring nullable

providerstring nullable

modelstring nullable

api_keystring nullable

Raw API key; if provided, replaces the stored alias.

clear_api_keyboolean nullable

If true, clears any stored api_key_alias (reverts to Cyberdesk-provided key if supported).

temperaturenumber nullable

max_tokensinteger nullable

timeout_secondsnumber nullable

max_retriesinteger nullable

additional_paramsobject nullable

agent_harness_version_stringstring nullable

is_computer_use_modelboolean nullable

is_archivedboolean nullable

Response

Successful Response

namestring required

descriptionstring nullable

providerstring required

LangChain provider name (e.g. 'anthropic', 'openai').

modelstring required

Provider model identifier (e.g. 'claude-sonnet-4-5-20250929').

temperaturenumber nullable

max_tokensinteger nullable

timeout_secondsnumber nullable

max_retriesinteger nullable

additional_paramsobject nullable

Provider-specific kwargs passed through to LangChain.

agent_harness_version_stringstring nullable

Agent harness version string used by Cyberdesk workers for prompt/tool selection.

is_computer_use_modelboolean

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_archivedboolean

Whether this model configuration is archived and should generally be hidden behind archived-model UI affordances.

idstring uuid required

organization_idstring nullable

api_key_aliasstring nullable

Basis Theory token id (alias) used to resolve api_key at runtime.

is_system_defaultboolean required

created_atstring date-time required

updated_atstring date-time required