Sign in

v27

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-01304498.9 KB
maasmodelrefs

Update a MaaSModelRef

Updates an existing MaaSModelRef Kubernetes custom resource. K8s calls: PUT /k8s/v1/maasmodelref/:namespace/:name

put/api/v1/maasmodel/{namespace}/{name}

Path parameters

namespacestring required

Namespace of the MaaSModelRef

namestring required

Name of the MaaSModelRef to update

Request body

endpointOverridestring

Optional endpoint URL override

displayNamestring

Human-readable display name stored as openshift.io/display-name annotation

descriptionstring

Human-readable description stored as openshift.io/description annotation

modelCapabilitiesstring[]

Model capability tags to set as the opendatahub.io/model-capabilities annotation. Omit to leave the existing annotation unchanged; send an empty array to remove it.

Example request

{
  "modelRef": {
    "kind": "LLMInferenceService",
    "name": "llama-2-7b-chat"
  },
  "displayName": "Granite 3 8B Instruct",
  "description": "A high-performance instruction-tuned language model",
  "modelCapabilities": [
    "text-generation",
    "vision"
  ]
}

Response

MaaSModelRef updated successfully

namestring required

Name of the MaaSModelRef resource

namespacestring required

Namespace of the MaaSModelRef resource

displayNamestring

Human-readable display name (from openshift.io/display-name annotation)

descriptionstring

Optional description of the model (from openshift.io/description annotation)

phase'Pending' | 'Ready' | 'Unhealthy' | 'Failed'

Current phase of the model (from status)

statusMessagestring

Human-readable status message from the Ready condition in status.conditions

endpointstring

Endpoint URL for the model (from status)

modelCapabilitiesstring[]

Model capability tags from the opendatahub.io/model-capabilities annotation (e.g. text-generation, vision). Absent when the annotation was not set.

Example response

{
  "name": "llama-2-7b-chat",
  "namespace": "maas-models",
  "displayName": "Granite 3 8B Instruct",
  "description": "IBM Granite 3 8B instruction-tuned language model.",
  "modelRef": {
    "kind": "LLMInferenceService",
    "name": "llama-2-7b-chat"
  },
  "phase": "Ready",
  "endpoint": "https://llama-2-7b-chat.example.com",
  "modelCapabilities": [
    "text-generation",
    "vision"
  ]
}