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

Changes

Changed in 7 of the 32 revisions of this API.113

Aug 6, 20269112415ceeca4See the full diff
- ○
  added the optional property conditionType to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property lastTransitionTime to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property status to the response with the 201 status
  response-optional-property-added
Jul 13, 202641f9c4a9d8d92See the full diff
- ○
  added the new optional request property modelCapabilities
  new-optional-request-property
- ○
  added the optional property modelCapabilities to the response with the 201 status
  response-optional-property-added
Jul 10, 2026a7f523a6836e1See the full diff
- ○
  added the optional property statusMessage to the response with the 201 status
  response-optional-property-added
Apr 2, 2026940b8bb750fe3See the full diff
- ○
  added the new optional request property description
  new-optional-request-property
- ○
  added the new optional request property displayName
  new-optional-request-property
- ○
  added the new optional request property uid
  new-optional-request-property
Mar 30, 2026b624ef0376c52See the full diff
- ○
  added the optional property description to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property displayName to the response with the 201 status
  response-optional-property-added
Mar 18, 20264e69495b0c8e1See the full diff
- ○
  endpoint added
  endpoint-added
Feb 2, 20262321745544981See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 41 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history