Sign in

v29

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-063044104.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

reasonstring

Reason from the Ready condition in status.conditions

statusstring

Status from the Ready condition in status.conditions (e.g. True, False, Unknown)

conditionTypestring

Condition type from the Ready condition in status.conditions

lastTransitionTimestring date-time

lastTransitionTime 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",
  "reason": "Reconciled",
  "status": "True",
  "conditionType": "Ready",
  "lastTransitionTime": "2026-01-01T00:00:00Z",
  "endpoint": "https://llama-2-7b-chat.example.com",
  "modelCapabilities": [
    "text-generation",
    "vision"
  ]
}