v1

latestOpenAPI 3.1.02026-07-22136108233.0 KB

model-configurations

Create Model Configuration

post/v1/model-configurations

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 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.

api_keystring nullable

Raw API key (stored in Basis Theory; never persisted directly).

Response

Successful Response