v27

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

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"
  ]
}