Skip to content

Update a model

PATCH
/v1/llm-models/{id}
id
required
string

Model ID (prefixed, e.g., mod_…)

Request to update an LLM model. Only provided fields will be updated.

object
capabilities

List of capabilities this model supports.

array | null
Example
[
"chat",
"tools"
]
display_name

Human-readable display name for the model.

string | null
Example
GPT-4o Mini
enabled

Whether this model should be enabled (visible in UI model pickers).

boolean | null
Example
true
is_favorite

Whether this model should be marked as a favorite for quick access.

boolean | null
Example
true
model_id

The model identifier used by the provider’s API.

string | null
Example
gpt-4o-mini
provider_id

Provider that owns this model.

string | null
Example
provider_019df670b5af7db7a5685a4ad18a544a

Model updated

Wrapper that adds API and UI links to a serialized resource.

Uses self_url (not url) for the API link to avoid collision with resources that already have a url field (e.g. McpServer).

object
capabilities
required
Array<string>
created_at
required
string format: date-time
display_name
required
string
enabled
required

Whether this model is enabled (visible in UI model pickers). All models are available via API regardless of this flag.

boolean
id
required
string
Example
model_01933b5a00007000800000000000001
is_favorite
required
boolean
model_id
required
string
provider_id
required
string
Example
provider_01933b5a00007000800000000000001
source
required

How the model was added to the system

string
Allowed values: manual discovered predefined
updated_at
required
string format: date-time
self_url
required

Full API endpoint URL for this resource.

string
ui_link
required

Alias for view_url, used by command and MCP outputs.

string
view_url
required

Full UI URL for viewing this resource.

string

Invalid model ID

Model not found