Sign in

v29

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

Create a MaaSModelRef

Creates a new MaaSModelRef Kubernetes custom resource. K8s calls: POST /k8s/v1/maasmodelref

post/api/v1/maasmodel

Request body

namestring required

Name for the MaaSModelRef resource

namespacestring required

Namespace for the MaaSModelRef resource

endpointOverridestring

Optional endpoint URL override

uidstring

UID of the OwnerReference Resource

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 copied from the opendatahub.io/model-capabilities annotation on the source LLMInferenceService (e.g. text-generation, vision). Omit or leave empty when the annotation is absent.

Example request

{
  "name": "granite-3-8b-instruct",
  "namespace": "maas-models",
  "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 created 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"
  ]
}